UniFi Network MCP
sirkirby/unifi-mcp
Gives Claude direct access to your UniFi controller with 169 tools covering devices, clients, firewall rules, VLANs, VPNs, and network topology. Built for UniFi Network specifically, with sibling servers for Protect and Access if you need cameras or door control. Supports lazy tool loading to keep context lean, or eager mode if your client wants everything up front. The standout feature is the relay sidecar that lets cloud AI agents reach your local controller through a Cloudflare Worker without port forwarding. Use it when you want to audit firewall policies, track client behavior across VLANs, or automate network changes through natural language instead of clicking through the UniFi dashboard.
- GitHub stars
- 420
- tools
- 5
- auth
- Secret needed
- transport
- STDIO
- env vars
- 7
- last updated
- Mar 24, 2026
Install
From registry metadata$ npx add-mcp 'uvx unifi-network-mcp' --name unifi-network-mcp --env 'UNIFI_HOST=${UNIFI_HOST}' --env 'UNIFI_USERNAME=${UNIFI_USERNAME}' --env 'UNIFI_PASSWORD=${UNIFI_PASSWORD}' --env 'UNIFI_API_KEY=${UNIFI_API_KEY}'Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add unifi-network-mcp --env UNIFI_HOST=YOUR_UNIFI_HOST --env UNIFI_USERNAME=YOUR_UNIFI_USERNAME --env UNIFI_PASSWORD=YOUR_UNIFI_PASSWORD --env UNIFI_API_KEY=YOUR_UNIFI_API_KEY --env UNIFI_PORT=443 --env UNIFI_VERIFY_SSL=false --env UNIFI_SITE=default -- uvx unifi-network-mcpRun in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.
Tools
Verified live · 5 toolsVerified live against the running server on Jun 11, 2026.
unifi_tool_indexModel-friendly discovery extension for UniFi Network tools. This server manages WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics. Standard MCP clients should use tools/list first; this compact index is an optional UniFi extension for filte...3 params
Model-friendly discovery extension for UniFi Network tools. This server manages WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics. Standard MCP clients should use tools/list first; this compact index is an optional UniFi extension for filte...
Parameters* required
categoryvalueinclude_schemasbooleandefault: false
searchvalueunifi_executeExecute a UniFi Network tool discovered via unifi_tool_index. This server manages WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics. This is a UniFi compatibility execution wrapper for lazy/meta-only workflows; standard MCP clients may call...2 params
Execute a UniFi Network tool discovered via unifi_tool_index. This server manages WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics. This is a UniFi compatibility execution wrapper for lazy/meta-only workflows; standard MCP clients may call...
Parameters* required
argumentsobjecttool*stringunifi_batchExecute multiple UniFi Network tools in parallel through a UniFi compatibility wrapper. Use unifi_tool_index to discover tool names when they are not directly registered. Returns job IDs for each operation. Use unifi_batch_status to check progress and get results. For single o...1 params
Execute multiple UniFi Network tools in parallel through a UniFi compatibility wrapper. Use unifi_tool_index to discover tool names when they are not directly registered. Returns job IDs for each operation. Use unifi_batch_status to check progress and get results. For single o...
Parameters* required
operations*arrayunifi_batch_statusCheck status of UniFi Network operations started with unifi_batch. Returns status ('running', 'done', 'error'), result (if done), or error (if failed). Can check multiple jobs at once by passing an array of job IDs.2 params
Check status of UniFi Network operations started with unifi_batch. Returns status ('running', 'done', 'error'), result (if done), or error (if failed). Can check multiple jobs at once by passing an array of job IDs.
Parameters* required
jobIdstringjobIdsarrayunifi_load_toolsLoad UniFi Network tools (WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics) into the standard MCP tools/list surface. This is an advanced UniFi extension for lazy mode clients that support notifications/tools/list_changed. Clients that do...1 params
Load UniFi Network tools (WiFi networks, clients, devices, switches, APs, firewall, VPN, routing, and statistics) into the standard MCP tools/list surface. This is an advanced UniFi extension for lazy mode clients that support notifications/tools/list_changed. Clients that do...
Parameters* required
tools*arraySponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
UNIFI_HOST*Controller IP/hostname
UNIFI_USERNAME*secretAdmin username
UNIFI_PASSWORD*secretAdmin password
UNIFI_API_KEYsecretAPI key (optional, experimental)
UNIFI_PORTdefault: 443Controller HTTPS port
UNIFI_VERIFY_SSLdefault: falseSSL certificate verification
UNIFI_SITEdefault: defaultUniFi site name
Readme
UniFi MCP
UniFi MCP — AI agents for your UniFi infrastructure
Leverage agents and agentic AI workflows to manage your UniFi deployment.
Details
- Repository
- github.com/sirkirby/unifi-mcp
- Category
- Security & Pentesting
- Package
unifi-network-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
- Tools verified
- Jun 11, 2026
