UniFi Protect MCP server
Manage UniFi Protect cameras, events, recordings, and smart detections via MCP.
853 stars1.0k downloads/wk
Reviews
Write oneNobody has reviewed UniFi Protect MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
UniFi Protect MCP tools (34, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
protect_acknowledge_eventAcknowledge an event with preview/confirm.
protect_create_liveviewwrite actionCreate a liveview (validation only -- API limitation).
protect_delete_liveviewwrite actionDelete a liveview (not supported via API).
protect_delete_recordingwrite actionDelete recording for a camera (not supported by API).
protect_export_clipExport a video clip from a camera.
protect_get_cameraGet detailed camera information by ID.
protect_get_camera_analyticsGet motion/smart detection analytics for a camera.
protect_get_camera_streamsGet stream URLs for a camera.
protect_get_eventGet a single event by ID.
protect_get_event_thumbnailGet event thumbnail.
protect_get_firmware_statusGet firmware status for NVR and devices.
protect_get_healthGet Protect NVR health metrics.
protect_get_recording_statusGet recording status for one or all cameras.
protect_get_snapshotGet a snapshot from a camera.
protect_get_system_infoGet Protect NVR system information.
protect_list_camerasList all cameras.
protect_list_chimesList all chimes.
protect_list_eventsList events from the NVR.
protect_list_lightsList all lights.
protect_list_liveviewsList all liveviews.
protect_list_recordingsList recording availability for a camera.
protect_list_sensorsList all sensors.
protect_list_smart_detectionsList smart detection events.
protect_list_viewersList connected Protect viewers.
protect_ptz_moveAdjust PTZ camera position (zoom only; pan/tilt via presets).
protect_ptz_presetMove PTZ camera to a preset position.
protect_reboot_cameraReboot a camera with preview/confirm.
protect_recent_eventsGet recent events from the websocket buffer.
protect_subscribe_eventsReturn subscription instructions for event streaming.
protect_toggle_recordingToggle camera recording on/off with preview/confirm.
protect_trigger_chimeTrigger a chime to play its tone.
protect_update_camera_settingswrite actionUpdate camera settings with preview/confirm.
protect_update_chimewrite actionUpdate chime settings with preview/confirm.
protect_update_lightwrite actionUpdate light settings with preview/confirm.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan38 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 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install UniFi Protect MCP in Claude Code, Cursor or VS Code
claude mcp add unifi-protect-mcp -- uvx unifi-protect-mcp
What the publisher says
From the UniFi Protect MCP repository's README, as published. We do not edit it. Read it on GitHub
UniFi MCP
Leverage agents and agentic AI workflows to manage your UniFi deployment.
Servers
Choose an integration
An MCP adapter can expose a small set of tools while using unifi-api-server as its backend. This keeps application-specific joins, branching, loops, and code isolation out of the general-purpose MCP servers.
Cloud Relay
Cloud Relay pairs the Cloudflare-hosted Worker gateway with the Relay sidecar on your LAN. The Worker provides the authenticated edge MCP endpoint, Durable Object broker, multi-location routing, token boundary, and deployment/management CLI. The Relay sidecar is a local MCP HTTP client and forwarder: it discovers configured local MCP servers over HTTP and maintains an outbound WebSocket to the Worker. Remote requests follow MCP client → Worker gateway → outbound WebSocket → Relay sidecar → local MCP servers over HTTP; the API server is not in this path. Read-only tools support annotation-based multi-location fan-out, while writes require explicit location targeting. Deploy the Worker with npm install -g unifi-mcp-worker && unifi-mcp-worker install, then see the Relay sidecar README to connect local servers.
REST + GraphQL API
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
UniFi Protect MCP: common questions
- Is UniFi Protect MCP server safe?
- Mostly: it is graded B (83/100). Read the UniFi Protect MCP safety report
- How do I install UniFi Protect MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does UniFi Protect MCP need an API key?
- Yes. The registry entry asks for
UNIFI_USERNAME,UNIFI_PASSWORD,UNIFI_API_KEY. - Is UniFi Protect MCP maintained?
- The last commit was in the last day (2026-09-27). The latest release is v0.1.6.