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, or unifi_get_motion_events via 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