← all repositories
sirkirby/unifi-mcp

AI agents can now reconfigure your UniFi network—after asking nicely

A suite of MCP servers that lets AI assistants manage your UniFi network, cameras, and access control through natural-language commands.

733 stars Python Coding AssistantsAgents
unifi-mcp
Velocity · 7d
+6.6
★ / day
Trend
accelerating
star history

What it does

UniFi MCP is a set of Model Context Protocol servers for Ubiquiti’s UniFi ecosystem. It exposes Network, Protect, and Access controllers as tool collections that AI agents can query and command. A separate REST and GraphQL API server offers the same capabilities for non-MCP clients, while a Cloudflare Worker relay lets cloud-hosted agents reach local controllers without opening ports.

The interesting bit

The project treats operational safety as a first-class feature. Every mutation runs through a preview-then-confirm flow, and responses automatically redact Wi-Fi passphrases, VPN keys, and API tokens so they never leak into agent context or logs. It also supports lazy tool discovery, exposing meta-tools first rather than flooding the prompt with all 180+ Network functions at once.

Key highlights

  • Network server is stable with 180 tools; Protect and Access servers are in beta with 59 and 34 tools respectively.
  • Built-in secret redaction masks sensitive fields like Wi-Fi passwords and VPN configurations by default.
  • Cloud relay sidecar and worker gateway enable multi-location, read-only fan-out to cloud agents without port forwarding.
  • Standalone unifi-api-server provides REST and GraphQL endpoints for dashboards and desktop apps that do not speak MCP.
  • Supports multi-controller setups through prefixed environment variables.

Caveats

  • Network MCP does not support accounts that require SSO MFA or local 2FA; you must use a dedicated local admin account without MFA.
  • Protect, Access, Relay, Worker Gateway, and API Server are all currently in beta.
  • Experimental API-key authentication is read-only and covers only a subset of tools.

Verdict

Worth a look if you run a UniFi stack and want to let AI agents handle routine network audits, camera checks, or access-log queries. Skip it if you need full production stability across every component or require MFA on your service accounts.

Frequently asked

What is sirkirby/unifi-mcp?
A suite of MCP servers that lets AI assistants manage your UniFi network, cameras, and access control through natural-language commands.
Is unifi-mcp open source?
Yes — sirkirby/unifi-mcp is open source, released under the MIT license.
What language is unifi-mcp written in?
sirkirby/unifi-mcp is primarily written in Python.
How popular is unifi-mcp?
sirkirby/unifi-mcp has 733 stars on GitHub and is currently accelerating.
Where can I find unifi-mcp?
sirkirby/unifi-mcp is on GitHub at https://github.com/sirkirby/unifi-mcp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.