Skip to main content
UniFi MCP Server is an open-source Model Context Protocol (MCP) server that connects AI assistants directly to your UniFi network infrastructure. Once installed, you can manage devices, configure networks, set firewall rules, monitor traffic, and automate backups — all through natural language conversations with your AI assistant.

Quick Start

Install the server and connect your first AI assistant in minutes.

API Modes

Choose between Local Gateway, Cloud v1, and Cloud EA access modes.

MCP Client Setup

Connect Claude Desktop, Cursor, or any MCP-compatible AI client.

Tool Reference

Browse all 77 available tools for network management and automation.

​
What you can do

With UniFi MCP Server, your AI assistant gains the ability to interact with your entire UniFi network. You can ask it to list all connected devices, block a suspicious client, create a guest WiFi network, set up firewall rules, or generate a network topology diagram — and it will do so using the official UniFi API.

Device Management

Monitor, restart, locate, and upgrade UniFi devices.

Network Config

Create and manage networks, VLANs, and subnets.

Firewall & Security

Manage firewall rules, zones, and ACLs.

WiFi Management

Create and configure SSIDs with WPA2/WPA3 and guest isolation.

QoS & Traffic

Prioritize traffic with QoS profiles and bandwidth controls.

Backup & Restore

Schedule automated backups with integrity verification.

​
Get started in 3 steps

1

Get your UniFi API key

Log in to unifi.ui.com, navigate to Settings → Control Plane → Integrations, and create an API key. Save it — it’s shown only once.
2

Install the server

Or use Docker: docker pull ghcr.io/enuno/unifi-mcp-server:latest
3

Connect your AI assistant

Add the server to your MCP client configuration (Claude Desktop, Cursor, or any MCP-compatible client) and start managing your network through natural language.
For full network management capabilities — creating networks, configuring firewalls, and controlling devices — use the Local Gateway API mode (UNIFI_API_TYPE=local). Cloud API modes are limited to read-only site statistics.