# UniFi MCP

> UniFi MCP is an open-source MCP server for cloud and infrastructure. Unofficial MCP server for UniFi Network with drift and topology checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/unifi-network
- **MCP Registry name:** io.github.Servosity/unifi-network-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud App Platform](https://ai-powered.com/mcp/kubana-cloud-app-platform): Kubana Cloud App Platform is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/unifi-mcp-2
