Unifi MCP server
io.github.mikeholownych/unifi-mcp·v0.8.2·2 starsMCP server for Ubiquiti UniFi Network and Protect. 63 tools, 16 agent skills.
2 stars35 downloads/wk
Reviews
Write oneNobody has reviewed Unifi yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Unifi tools (66, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_network_issuesAnalyze the network for potential issues and return a structured report.
archive_all_alarmsArchive all active alarms.
block_clientBlock a client from the network.
create_firewall_policywrite actionCreate a zone-based firewall policy (UniFi Network 9+).
create_port_forwardwrite actionCreate a port forwarding rule on the gateway.
create_wlanwrite actionCreate a wireless network (SSID) with WPA2/WPA3 transition security.
delete_firewall_policywrite actionDelete a zone-based firewall policy. Requires confirm=true.
delete_port_forwardwrite actionDelete a port forwarding rule. Requires confirm=true.
delete_wlanwrite actionDelete a wireless network (SSID). Requires confirm=true.
export_camera_clipExport a camera recording clip (MP4) to a local file. Requires Protect credentials.
forget_clientwrite actionRemove a client from the known clients list.
get_alarmsGet active alarms.
get_all_sites_healthGet health overview across all sites.
get_camera_detailsGet detailed information about a specific camera.
get_camera_health_summaryGet a health summary of all cameras.
get_camera_snapshotGet a snapshot from a camera.
get_client_detailsGet detailed information about a specific client.
get_client_experience_reportGenerate a client experience report with connection quality metrics.
get_client_trafficGet traffic statistics for a specific client.
get_device_detailsGet detailed information about a specific device.
get_device_health_summarySummarize device health across all APs, switches, and routers.
get_device_statsGet performance statistics for a device.
get_dpi_statsGet Deep Packet Inspection statistics for the site.
get_firewall_policiesGet zone-based firewall policies (UniFi Network 9+).
get_firewall_rulesGet firewall rule configurations.
get_global_client_summaryGet a summary of all connected clients across all controllers.
get_global_healthGet health summary across all configured controllers.
get_global_inventoryGet a unified inventory of all devices across all configured controllers.
get_liveviewsGet all configured Protect liveviews.
get_motion_eventsGet recent motion events from cameras.
get_network_healthGet overall network health summary.
get_networksGet all network/VLAN configurations.
get_optimization_recommendationsAnalyze network configuration and provide optimization recommendations.
get_port_forwardsGet all port forwarding rules (external port+protocol → internal IP+port).
get_port_profilesGet switch port profile configurations.
get_protect_accessoriesGet all Protect accessories (lights, sensors, chimes, viewers).
get_protect_event_summaryGet a summary of all Protect events for the time period.
get_protect_system_infoGet UniFi Protect system information including camera and accessory counts.
get_recent_eventsGet recent network events.
get_recent_protect_activityGet recent activity across all cameras.
get_routing_tableGet the current routing table.
get_site_healthGet comprehensive health status for a site.
get_site_settingsGet site configuration settings.
get_smart_detectionsGet smart detection events (person, vehicle, animal, package).
get_speed_test_statusGet speed test status and results.
get_sysinfoGet system information for the site controller.
get_traffic_analysisAnalyze traffic patterns over the specified time period.
get_traffic_summaryGet traffic summary for the site.
get_wlansGet all wireless network (SSID) configurations.
kick_clientDisconnect a client (they can reconnect).
list_all_clientsList all known clients (including offline).
list_camerasList all UniFi Protect cameras with status.
list_clientsList all currently connected clients.
list_devicesList all UniFi network devices (APs, switches, routers).
list_sitesList all UniFi sites accessible to the current user.
list_unifi_devicesList all configured UniFi devices.
locate_deviceEnable/disable LED blinking to locate a device.
provision_deviceForce re-provision a device with current configuration.
reserve_client_ipReserve a device's current IP (or a specific one) via DHCP reservation.
restart_deviceRestart a UniFi device.
run_speed_testwrite actionInitiate a WAN speed test.
set_firewall_policy_enabledEnable or disable a zone-based firewall policy.
troubleshoot_clientDeep-dive troubleshooting for a specific client.
unblock_clientUnblock a previously blocked client.
update_wlanwrite actionUpdate a wireless network (SSID) by ID or name - only provided fields change.
upgrade_deviceUpgrade device firmware to the latest version.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan21 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Unifi compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 68% of 4,460 AI and agents servers
- Tools
- 66
- the typical AI and agents server has 6
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 65% of 2,711 AI and agents servers
- Downloads a week
- 35
- more than 25% of 1,538 AI and agents servers with a package
What its tools let an agent do: 54 read · 3 create · 3 change · 4 delete · 2 run or deploy
Install Unifi in Claude Code, Cursor or VS Code
claude mcp add unifi-mcp -- uvx mcp-unifi
What the publisher says
From the Unifi repository's README, as published. We do not edit it. Read it on GitHub
UniFi MCP Server
mcp-name: io.github.mikeholownych/unifi-mcp
An MCP (Model Context Protocol) server that provides AI assistants like Claude with access to UniFi Network and Protect infrastructure management and analysis capabilities. It uses the native MCP SDK 2 MCPServer API (not FastMCP 3) and communicates over stdio by default.
Credits: This project started as a fork of gbassaragh/Unifi-mcp and has since evolved into a fully independent project. Thanks to @gbassaragh for the excellent starting point.
Improvements Over Upstream
- Fixed local session authentication routing — in UNIFI_MODE=local, requests now correctly use the traditional controller API (/proxy/network) with cookie + CSRF session auth. Upstream always routed through the Integration API regardless of mode.
- Mode-aware base URL resolution — apibaseurl now respects the configured auth mode instead of unconditionally returning the Integration API endpoint.
- Expanded test suite — 250+ passing tests covering configuration, MCP compatibility, runtime persistence, network client behavior, server tool registration, and Protect integrations.
Features
UniFi Network
- Device Management: List, restart, locate, and upgrade UniFi devices (APs, switches, routers)
- Client Management: Monitor connected clients, block/unblock, view traffic statistics
- Site Management: View site health, network configurations, VLANs, and wireless settings
- Statistics & Monitoring: Events, alarms, speed tests, and DPI statistics
- AI-Powered Insights: Network analysis, optimization recommendations, and troubleshooting
UniFi Protect
- Camera Management: List cameras, view status, get live snapshots
- System Monitoring: NVR status, camera health summaries
- Accessories: Manage lights, sensors, chimes, and viewers
- Liveviews: Access configured camera view layouts
Multi-Device Support
- Configure multiple UniFi devices (gateways, NVRs, etc.)
- Target specific devices by name — all network and Protect tools accept an optional device parameter
- Per-device API keys: each configured device authenticates with its own key
- Mix of Network and Protect services across devices
Events and Safe Automation
- Normalize and durably deduplicate Network and Protect events in optional SQLite storage
- Poll each configured source independently and report unsupported capabilities explicitly
- Run only built-in interval jobs: pollevents, retrywebhookdeliveries, captureobservations, and pruneruntimedata
- Deliver filtered, signed HTTPS webhooks with bounded retries and dead-letter state
- Keep persistence, background automation, and private webhook destinations disabled by default
Authentication Modes
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Unifi: common questions
- Is Unifi MCP server safe?
- Mostly: it is graded B (83/100). Read the Unifi safety report
- How do I install Unifi?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Unifi need an API key?
- Yes. The registry entry asks for
UNIFI_PASSWORD. - Is Unifi maintained?
- The last commit was 11 days ago (2026-10-24). The latest release is v0.8.2.
- What can I use instead of Unifi?
- Servers from other publishers that do the same job: Pm Claude Skills MCP server, Watch Skill MCP server and mcptoon MCP server.
- How does Unifi compare with other AI and agents MCP servers?
- safety score 83/100 (higher than 68% of 4,460 AI and agents servers); tools 66 (the typical AI and agents server has 6); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Unifi
Same job from other publishers: the closest match first, then the best rated.
- Pm Claude Skills1310 professional Agent Skills + workflow recipes — searchable & fetchable over MCP.not reviewedEstablishedA
- Watch SkillWatch video and live sessions, keep timestamped evidence, and verify an agent's own work.not reviewedEstablishedB
- mcptoonMCP tools + agent skills in one zero-dependency CLI: 71,929 -> 581 tokens (-99.2%, measured).not reviewedEstablishedA
- three.ws MarketplaceBrowse and discover the public three.ws agent marketplace and skills catalog. Read-only.not reviewedEstablishedA
- SkillsmithShare agent skills across your team, scan them for risk, and track what's actually used.not reviewedEstablishedB