Skip to content
MCP server

UniFi MCP

Unofficial MCP server for UniFi Network with drift and topology checks

Runs locallyStatus and history
Install
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.mcpb

Add 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.Required
  • UNIFI_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.Required
  • UNIFI_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

  1. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  2. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  3. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents
  4. MagicWP MCP

    MCP server

    Run WordPress hosting from an assistant: backups, staging, updates, PHP and domains

    • Remote
    • Free trial
    • Cloud and infrastructure
  5. Search, register and renew domains and set nameservers at Kubana Cloud from an assistant

    Not checked yet
    • 3 tools
    • Remote
    • Paid
    • Cloud and infrastructure
  6. AgentViva

    MCP server

    Uptime monitoring for AI tools, APIs and MCP servers, reachable from any MCP client

    • 1 tool
    • Remote
    • Free
    • Developer tools