UniFi MCP

Log in to ui.com, go to your account settings, and create an API key. For full access to all 54 tools including Cloud Connector, create a second key with Owner role. Copy both keys — you will need them for the MCP config.

# UniFi API key creation:
# https://account.ui.com/ > Security > API Keys

Before configuring your MCP client, validate your setup using the built-in doctor command. This checks that your API keys are valid and that the server can reach the UniFi API.

npx -y @us-all/unifi-mcp --doctor

Add the UniFi MCP server to your client configuration with your API keys. UNIFI_API_KEY_OWNER is optional but unlocks the Cloud Connector tools (33 additional tools beyond the base 9 Site Manager tools).

{
  "mcpServers": {
    "unifi": {
      "command": "npx",
      "args": ["-y", "@us-all/unifi-mcp"],
      "env": {
        "UNIFI_API_KEY": "your-admin-api-key-here",
        "UNIFI_API_KEY_OWNER": "your-owner-api-key-here"
      }
    }
  }
}

To unlock per-port error counters and SFP diagnostics (2 additional tools), add your local UniFi controller URL and credentials. This is optional and only needed for those advanced tools.

{
  "mcpServers": {
    "unifi": {
      "command": "npx",
      "args": ["-y", "@us-all/unifi-mcp"],
      "env": {
        "UNIFI_API_KEY": "your-admin-api-key-here",
        "UNIFI_API_KEY_OWNER": "your-owner-api-key-here",
        "UNIFI_LOCAL_URL": "https://192.168.1.1",
        "UNIFI_LOCAL_USER": "admin",
        "UNIFI_LOCAL_PASS": "your-local-password"
      }
    }
  }
}

Restart Claude Desktop or your MCP client after saving the configuration. Ask the AI to run a fleet health check as your first query to confirm all sites and devices are reporting correctly.