Best for
- Home-automation users with a local UniFi controller
- Users who want an AI assistant to query Protect cameras, recordings, and detection events
- UniFi Protect deployments that can provide a local administrator or service account
U
UniFi Protect MCP
Community
Manage UniFi Protect cameras and events through MCP.
GitHub source repository ↗
66FMRS · C
The source identifies this server as focused on UniFi Protect and using stdio transport; its PyPI package is unifi-protect-mcp 0.7.5. The repository also contains Network and Access servers, whose tools must not be attributed to this server.
UniFi Protect MCP is a stdio MCP server for managing UniFi Protect cameras, events, recordings, and smart detections. It is part of a repository containing multiple UniFi MCP servers; this profile covers only the Protect server. Version 0.7.5 provides 61 tools.
Tools
The tool list has not been reviewed yet.
Setup
Run unifi-protect-mcp@latest with uvx and configure UNIFI_PROTECT_HOST, UNIFI_PROTECT_USERNAME, and UNIFI_PROTECT_PASSWORD. The shared UNIFI_HOST, UNIFI_USERNAME, and UNIFI_PASSWORD variables are also supported. UNIFI_PORT defaults to 443 and UNIFI_VERIFY_SSL defaults to false; UNIFI_API_KEY is optional and experimental.
claude_desktop_config.json
{"mcpServers":{"unifi-protect":{"command":"uvx","args":["unifi-protect-mcp@latest"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_USERNAME":"admin","UNIFI_PROTECT_PASSWORD":"your-password"}}}}
Fit and risk
Not for
- Users who only have a Ubiquiti SSO cloud account
- Users seeking Network or Access server functionality
- Evaluations that require canonical tool names and a complete tool list when those identifiers are not provided in the source
Required permissions
- Access to the UniFi controller IP address or hostname
- A local administrator account username and password
- An optional API key for selected capabilities; the manifest labels this experimental
- Account permissions within the scope the user is comfortable granting to the MCP server
Risks and side effects
- Camera events and recordings may contain sensitive information about people and locations
- The server can manage Protect data and devices, so overly broad account permissions increase potential impact
- UNIFI_VERIFY_SSL defaults to false, so SSL certificates may not be verified
- The username, password, and optional API key are sensitive configuration values and should be protected
Troubleshooting
- Verify that the controller host is correct and reachable
- Use a local UniFi account rather than a Ubiquiti SSO cloud account
- Check the HTTPS port; the default is 443
- If the controller uses a self-signed certificate, review UNIFI_VERIFY_SSL
- Confirm the Protect-prefixed variable names, or use the shared UNIFI_* variables
- Because the API key is optional and experimental, check username and password authentication first
Use cases
List cameras that detected motion in the last hour
Show people and vehicle smart-detection events from a selected camera today
Find white-van detections in a driveway during the current week
Supported clients
Claude DesktopFull support
CodexPartial support
OpenClawPartial support