UniFi Protect MCP
UniFi Protect MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Manage UniFi Protect cameras, events, recordings, and smart detections via MCP. It has 1,076 GitHub stars, is released under the MIT license and runs locally with uvx unifi-protect-mcp.
github.com/sirkirby/unifi-mcp (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install UniFi Protect MCP
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"unifi-protect-mcp": {
"command": "uvx",
"args": [
"unifi-protect-mcp"
],
"env": {
"UNIFI_HOST": "your-value",
"UNIFI_USERNAME": "your-value",
"UNIFI_PASSWORD": "your-value",
"UNIFI_API_KEY": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env UNIFI_HOST=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value --env UNIFI_API_KEY=your-value --transport stdio unifi-protect-mcp -- uvx unifi-protect-mcpCursor
{
"mcpServers": {
"unifi-protect-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-protect-mcp"
],
"env": {
"UNIFI_HOST": "your-value",
"UNIFI_USERNAME": "your-value",
"UNIFI_PASSWORD": "your-value",
"UNIFI_API_KEY": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "unifi_username",
"description": "UNIFI_USERNAME",
"password": true
},
{
"type": "promptString",
"id": "unifi_password",
"description": "UNIFI_PASSWORD",
"password": true
},
{
"type": "promptString",
"id": "unifi_api_key",
"description": "UNIFI_API_KEY",
"password": true
}
],
"servers": {
"unifi-protect-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-protect-mcp"
],
"env": {
"UNIFI_HOST": "your-value",
"UNIFI_USERNAME": "${input:unifi_username}",
"UNIFI_PASSWORD": "${input:unifi_password}",
"UNIFI_API_KEY": "${input:unifi_api_key}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
UNIFI_HOST | Yes | Controller IP/hostname |
UNIFI_USERNAMEsecret | Yes | Admin username |
UNIFI_PASSWORDsecret | Yes | Admin password |
UNIFI_API_KEYsecret | No | API key (optional, experimental) |
UNIFI_PORT | No | Controller HTTPS port |
UNIFI_VERIFY_SSL | No | SSL certificate verification |
About UniFi Protect MCP
MCP server exposing UniFi Protect tools for AI assistants and other MCP-capable clients. Query cameras, events, smart detections, Find Anything detection search, recordings, lights, sensors, chimes, Known Faces, license plates, and the Alarm Manager with safe-by-default permissions and preview-before-confirm for all mutations.
- mcp-server
- unifi
- home-automation
- unifi-network
- unifi-access
- unifi-controller
- unifi-protect
- agentic-ai
Similar MCP servers
More other MCP servers
CartCut
cartesiancs/cartcut
Edit video in the CartCut desktop editor: cuts from a transcript, captions, motion, effects.
Active · last commit Nov 9, 2026
OfficialOtherTypeScriptDocling MCP
docling-project/docling-mcp
Convert PDFs and other documents to structured formats via Docling, for AI applications.
Active · last commit Nov 14, 2026
OtherPythonMCP Client For Ollama
jonigl/mcp-client-for-ollama
Harness the power of local LLMs with this TUI MCP Client for Ollama.
Active · last commit Oct 1, 2026
OtherPythonMCP Proxy
tbxark/mcp-proxy
An MCP proxy server that aggregates and serves multiple MCP resource servers through a single HTTP server.
Active · last commit Sep 15, 2026
OtherGoStyleKit
AnxForever/stylekit
MCP server for StyleKit styles, tokens, recipes, lint and repair over stdio or HTTP.
Maintained · last commit Nov 16, 2026
OtherTypeScriptyutu
eat-pray-ai/yutu
CLI, MCP server, and AI agent to automate YouTube workflows.
Active · last commit Nov 15, 2026
OfficialOtherGo
How do I install the UniFi Protect MCP MCP server?
Add the command uvx unifi-protect-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is UniFi Protect MCP free?
The server is open source under the MIT license, so running it is free. It needs credentials (UNIFI_USERNAME, UNIFI_PASSWORD and UNIFI_API_KEY) for the service it connects to, which may require a paid account.
Is UniFi Protect MCP actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is api/v0.29.0, published Nov 15, 2026. appsgit only lists MCP servers with a commit in the last six months.