# UniFi Network MCP (MCP server)

> UniFi Network MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Manage UniFi Network devices, clients, firewall, VLANs, VPNs, and more via MCP. It has 869 GitHub stars, is released under the MIT license and runs locally with uvx unifi-network-mcp.

MCP server exposing 209 UniFi Network Controller tools for AI assistants and other MCP-capable clients. Query clients, devices, firewall rules, VLANs, VPNs, Traffic Flows, stats, and more with safe-by-default permissions and preview-before-confirm for all mutations.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/sirkirby/unifi-mcp |
| GitHub stars | 869 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: unifi-network-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | api/v0.20.2 (Oct 1, 2026) |
| Last commit | Oct 1, 2026 |
| MCP registry name | io.github.sirkirby/unifi-network-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unifi-network-mcp": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env UNIFI_HOST=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value --env UNIFI_API_KEY=your-value --transport stdio unifi-network-mcp -- uvx unifi-network-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unifi-network-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "unifi_username",
      "description": "UNIFI_USERNAME",
      "password": true
    },
    {
      "type": "promptString",
      "id": "unifi_password",
      "description": "UNIFI_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "unifi_api_key",
      "description": "UNIFI_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "unifi-network-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unifi-network-mcp"
      ],
      "env": {
        "UNIFI_HOST": "your-value",
        "UNIFI_USERNAME": "${input:unifi_username}",
        "UNIFI_PASSWORD": "${input:unifi_password}",
        "UNIFI_API_KEY": "${input:unifi_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `UNIFI_HOST` (required): Controller IP/hostname
- `UNIFI_USERNAME` (secret) (required): Admin username
- `UNIFI_PASSWORD` (secret) (required): Admin password
- `UNIFI_API_KEY` (secret): API key (optional, experimental)
- `UNIFI_PORT`: Controller HTTPS port
- `UNIFI_VERIFY_SSL`: SSL certificate verification
- `UNIFI_SITE`: UniFi site name

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/unifi-network-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.