UniFi MCP
A set of MCP servers for UniFi: the agent works with Ubiquiti Network, Protect and Access controllers
- 1,044 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Works with network infrastructure and access systems
- Requires UniFi controller credentials
- Mutating operations affect a live network
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/unifi-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Works with network infrastructure and access systems
- Requires UniFi controller credentials
- Mutating operations affect a live network
This is third-party code. Review the repository files before installing.
What it does
The project bundles separate MCP servers per UniFi application: Network, Protect and Access. Each server exposes its application's features as MCP tools that are queryable and composable, with safe defaults. Read-only tools support fan-out across multiple locations, while writes require an explicit target location. Servers install via uvx from PyPI or as marketplace plugins, with a stdio transport and optional HTTP for trusted local clients. For remote access there is a cloud relay via a worker and sidecar.
Who it is for. For network and devops engineers who operate Ubiquiti UniFi gear.
Good fit when
- You need to query a UniFi Network controller from an agent
- You need to work with UniFi Protect cameras and events
- You need to manage access via UniFi Access
Not a fit when
- You have no UniFi controller credentials
- You do not want to give an agent access to network infrastructure
- You need remote access without setting up a secured relay
Example request
Show connected clients on the UniFi network and list access points with their statusMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
UNIFI_NETWORK_HOSTrequired- UniFi Network controller address
UNIFI_NETWORK_USERNAMErequired- Username for the UniFi controller
UNIFI_NETWORK_PASSWORDrequired, secret- Password for the UniFi controller
Limitations
You need the UniFi controller address and credentials, usually a username and password in environment variables. Python 3.13 or newer is required. The HTTP transport is off by default and unauthenticated, meant for trusted local clients; for external access use a secured proxy or the cloud relay. The Protect, Access and relay pieces are marked beta.
How to disable. Remove the unifi server entries from your MCP client config or uninstall the plugins via /plugin. For a uvx setup, removing the config entries is enough.
FAQ
Is it one server or several?
Several. Separate servers for Network, Protect and Access, each installed by its own PyPI package.
How do I enable remote access?
Through the cloud relay: a worker as the secured entry point and a local sidecar holding an outbound connection. Direct HTTP is only for trusted local clients.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server connects agents to UniFi infrastructure for device diagnostics, configuration reviews and approved changes
Juniper's MCP server: an agent runs commands and batch queries on Junos routers with blocklists for dangerous actions.
A self-hosted gateway that merges several MCP servers into one endpoint with auth and tool selection
CLI and TUI for UniFi controllers: devices, clients, VLANs, firewall and VPN from the terminal, plus a skill for coding agents
Official Cloudflare MCP server: the agent drives the whole Cloudflare API by searching the spec and running code
An MCP server for MikroTik RouterOS and SwOS: 133 typed tools with dry-run, snapshots and change rollback.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| UniFi MCP (this card) | no | API key | 1,044 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,032 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README describes a collection of UniFi MCP servers per application, Network, Protect and Access, each with its own PyPI package. It shows marketplace plugin installs for Claude Code, Codex and OpenClaw, plus direct uvx runs with UNIFI_NETWORK_HOST, USERNAME and PASSWORD. It details the transport security model, response modes keyed to the MCP protocol version, and a cloud relay built on a Cloudflare worker and a local sidecar. It also documents a standalone HTTP API service. MIT licensed.