UniFi Network MCP Server
by sirkirbyio.github.sirkirby/unifi-network-mcpv0.7.8
Manage UniFi Network devices, clients, firewall, VLANs, VPNs, and more via MCP.
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install UniFi Network MCP server
Install in Claude Code
claude mcp add network-sirkirby -e UNIFI_HOST='<unifi-host>' -e UNIFI_USERNAME='<unifi-username>' -e UNIFI_PASSWORD='<unifi-password>' -e UNIFI_API_KEY='<unifi-api-key>' -- uvx unifi-network-mcpInstall in Cursor
{
"mcpServers": {
"network-sirkirby": {
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<unifi-host>",
"UNIFI_USERNAME": "<unifi-username>",
"UNIFI_PASSWORD": "<unifi-password>",
"UNIFI_API_KEY": "<unifi-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"network-sirkirby": {
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<unifi-host>",
"UNIFI_USERNAME": "<unifi-username>",
"UNIFI_PASSWORD": "<unifi-password>",
"UNIFI_API_KEY": "<unifi-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"network-sirkirby": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<unifi-host>",
"UNIFI_USERNAME": "<unifi-username>",
"UNIFI_PASSWORD": "<unifi-password>",
"UNIFI_API_KEY": "<unifi-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"network-sirkirby": {
"command": "uvx",
"args": [
"unifi-network-mcp"
],
"env": {
"UNIFI_HOST": "<unifi-host>",
"UNIFI_USERNAME": "<unifi-username>",
"UNIFI_PASSWORD": "<unifi-password>",
"UNIFI_API_KEY": "<unifi-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| UNIFI_HOST | yes | — | Controller IP/hostname |
| UNIFI_USERNAME | yes | yes | Admin username |
| UNIFI_PASSWORD | yes | yes | Admin password |
| UNIFI_API_KEY | — | yes | API key (optional, experimental) |
| UNIFI_PORT | — | — | Controller HTTPS port |
| UNIFI_VERIFY_SSL | — | — | SSL certificate verification |
| UNIFI_SITE | — | — | UniFi site name |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · api/v0.20.5
Package published
no data · npm/PyPI
Registry entry updated
2026-03-24 · 7mo ago · official registry · v0.7.8
FAQ
›How do I install the UniFi Network MCP server in Claude Code?
Run: claude mcp add network-sirkirby -e UNIFI_HOST='<unifi-host>' -e UNIFI_USERNAME='<unifi-username>' -e UNIFI_PASSWORD='<unifi-password>' -e UNIFI_API_KEY='<unifi-api-key>' -- uvx unifi-network-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does UniFi Network require an API key?
Yes. It expects UNIFI_HOST, UNIFI_USERNAME, UNIFI_PASSWORD, UNIFI_API_KEY, of which 3 are secrets.
›Can I use UniFi Network as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is UniFi Network in the official MCP registry?
Yes, as io.github.sirkirby/unifi-network-mcp.