
UniFi MCP
Unofficial MCP server for UniFi Network with drift and topology checks
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.13
- Listing updated
- 2 days ago
About UniFi MCP
UniFi MCP is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
Not affiliated with Ubiquiti, this community connector exposes every UniFi Network API operation and adds three analysis features its README highlights: drift detection, topology mapping and rule prediction. Calls shell out to a companion unifi-network-cli, and bundles cut from 18 September 2026 onwards include that CLI.
The README opens with a security warning: do not run the HTTP transport, even on localhost, because that build has no password, listens on all interfaces and lacks a browser-rebinding guard; use the default stdio mode and close any tunnel. A fix is described as coming.
A client profile setting binds the server to one tenant so each call answers for a single customer, and credentials such as UNIFI_API_KEY are supplied as environment variables.
Install
Run in a terminal
claude mcp add unifi-network-mcp --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_GATEWAY_HOST='<UNIFI_GATEWAY_HOST>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"unifi-network-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_GATEWAY_HOST": "<UNIFI_GATEWAY_HOST>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"unifi-network-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_GATEWAY_HOST": "<UNIFI_GATEWAY_HOST>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"unifi-network-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_GATEWAY_HOST": "<UNIFI_GATEWAY_HOST>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unifi-network-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_GATEWAY_HOST": "<UNIFI_GATEWAY_HOST>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"unifi-network-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_GATEWAY_HOST": "<UNIFI_GATEWAY_HOST>"
}
}
}
}Configuration
PRINTING_PRESS_CLIENT_PROFILEBinds this MCP server to one tenant-gated client profile, so every call answers for that customer. Leave blank to use the profile configured as default_client_profile.UNIFI_API_KEYSet the UNIFI_API_KEY credential for the UniFi MCP server.RequiredUNIFI_BASE_PATHPath segment appended to the gateway host, when your controller does not serve the Network API at the standard location. Leave blank for a stock UniFi OS gateway.UNIFI_BASE_URLFull API base URL, e.g. https://10.0.0.1/proxy/network. Leave blank when you set the gateway host above; the CLI builds this from it.UNIFI_GATEWAY_HOSTSet the UNIFI_GATEWAY_HOST credential for the UniFi MCP server.RequiredUNIFI_MCP_READ_ONLYOptional. Set to 1 to list only read-only tools.
What it does
- Full UniFi Network API
- Covers every operation of the Network API.
- Drift detection
- Flags configuration that has moved from a baseline.
- Topology view
- Maps how devices and networks connect.
- Rule prediction
- Anticipates the effect of firewall rules.
- Per-client profiles
- Binds each call to one customer's tenant.
Good for
- Audit a customer's network config for drift
- Map a site's topology before a change
- Predict what a firewall rule will block
- Answer a client's network question from an assistant
Pricing
Open source
Free and open source; runs locally
UniFi MCP FAQ
Is it safe to run in HTTP mode?
The README says not to, until a fix ships; use stdio.
Who makes it?
A community project, not Ubiquiti.
How do I install it in Claude Desktop?
Download the .mcpb and select it under Settings > Extensions.
Is UniFi MCP free?
Yes. UniFi MCP is open source, so you can use and self-host it for free.
How do I add UniFi MCP to Claude Code?
Run this command in your terminal: claude mcp add unifi-network-mcp --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_GATEWAY_HOST='<UNIFI_GATEWAY_HOST>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/unifi-network-v0.1.13/unifi-network-mcp.mcpb
What are the best alternatives to UniFi MCP?
The closest alternatives to UniFi MCP are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.
Alternatives to UniFi MCP

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents

MagicWP MCP
MCP serverRun WordPress hosting from an assistant: backups, staging, updates, PHP and domains
- Remote
- Free trial
- Cloud and infrastructure

Kubana Cloud Domains
MCP serverSearch, register and renew domains and set nameservers at Kubana Cloud from an assistant
Not checked yet- 3 tools
- Remote
- Paid
- Cloud and infrastructure
AgentViva
MCP serverUptime monitoring for AI tools, APIs and MCP servers, reachable from any MCP client
- 1 tool
- Remote
- Free
- Developer tools