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

View on GitHub

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-mcp

Run in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.

Tools

Verified live · 5 tools

Verified 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

categoryvalue

include_schemasboolean

default: false

searchvalue

unifi_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

argumentsobject

tool*string

unifi_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*array

unifi_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

jobIdstring

jobIdsarray

unifi_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*array