sirkirby/unifi-mcp
MCP servers & Graph API for the UniFi suite of applications, Network, Protect, and Access
UniFi MCP
What it is: A collection of Model Context Protocol (MCP) servers that let AI assistants (like Claude, Codex, or custom agents) interact with Ubiquiti UniFi controllers. It exposes Network, Protect (cameras), and Access (door/visitor) functionality as callable tools for agents.
Key components:
- Network MCP (210 tools), Protect MCP (63 tools), Access MCP (37 tools) – each targets a UniFi app.
- API Server – an independent HTTP service (REST + GraphQL + SSE) for custom apps and automation, with scoped API keys.
- Cloud Relay – a beta solution for remote access: a Cloudflare-hosted Worker gateway pairs with a local relay sidecar to route MCP calls over a WebSocket, avoiding direct exposure of local servers.
- Agent plugins – official packages for Claude Code, Codex, and OpenClaw that bundle the MCP server with setup skills and safety guardrails.
How it works:
- Servers connect to your UniFi controller using a local admin account (not SSO).
- Agents call tools like
unifi_list_clients,unifi_create_firewall_rule, orunifi_get_motion_eventsvia standard MCP discovery. - Mutations use a preview-then-confirm flow; setup stores credentials in a private file and avoids leaking secrets.
- Lazy-loading mode keeps context small by exposing meta-tools that register domain tools on demand.
- Response sizes are adaptive based on the MCP protocol version for compatibility.
Quick start:
- For Claude Code:
/plugin marketplace add sirkirby/unifi-mcp, then install plugins. - For other clients: run
uvx unifi-network-mcp@latest, etc., and configure env vars.
Use cases:
- "Show me all clients on the Guest VLAN with signal strength."
- "List cameras that detected motion in the last hour."
- "Create a visitor pass for John Smith for tomorrow 9–5."
- Cross-product intelligence: investigate incidents with Network + Protect context.
The project is actively developed (plugins pinned to servers 0.37.x), has a security model, and is MIT-licensed. It's a genuine, substantial tool for AI‑driven infrastructure management.
Related
- Project
- Project
- Project
- Project
- Project