MCP server
Unifi
UniFi semantic-analysis MCP — fleet health, anomaly detection, cross-site analytics
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.13.3
- Listing updated
- 5 days ago
About Unifi
Unifi is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add unifi --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_API_KEY_OWNER='<UNIFI_API_KEY_OWNER>' --env UNIFI_LOCAL_PASS='<UNIFI_LOCAL_PASS>' -- npx -y @us-all/unifi-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"unifi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@us-all/unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/unifi-mcp"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
UNIFI_API_KEYUniFi Site Manager API key (https://unifi.ui.com).RequiredUNIFI_API_URLUniFi Site Manager API base URL (default: https://api.ui.com).UNIFI_API_KEY_OWNEROwner-role API key — enables 33 Cloud Connector tools for per-device/per-client deep data.UNIFI_TOOLSComma-separated category allowlist. Default: all categories enabled.UNIFI_DISABLEComma-separated category disablelist.UNIFI_LOCAL_URLLocal controller URL (e.g. https://10.10.1.1). Enables 2 local-only tools (get-port-errors, list-port-flap-summary) that surface per-port errors + SFP DDM the Cloud API does not expose. Requires LAN reachability.UNIFI_LOCAL_USERController local account username (required when UNIFI_LOCAL_URL set). Viewer/Limited-Admin role is sufficient.UNIFI_LOCAL_PASSController local account password (required when UNIFI_LOCAL_URL set).UNIFI_LOCAL_SITESite slug for legacy /api/s/{site}/* (default: default).UNIFI_LOCAL_INSECURESet to 'true' to accept self-signed cert from the local controller (typical for UDM Pro).
Pricing
Open source
Unifi FAQ
Is Unifi free?
Yes. Unifi is open source, so you can use and self-host it for free.
How do I add Unifi to Claude Code?
Run this command in your terminal: claude mcp add unifi --env UNIFI_API_KEY='<UNIFI_API_KEY>' --env UNIFI_API_KEY_OWNER='<UNIFI_API_KEY_OWNER>' --env UNIFI_LOCAL_PASS='<UNIFI_LOCAL_PASS>' -- npx -y @us-all/unifi-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.