Skip to content
MCPpedia
Submit
UniFi
Install guide · Cursor

Install UniFi for Cursor

Cursor reads ~/.cursor/mcp.json. A project can also commit .cursor/mcp.json.

Official Cursor docs
Add to Cursor: UniFiInstall in VS Code: UniFiInstall in VS Code Insiders: UniFi

Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.

  1. Open ~/.cursor/mcp.json on macOS, %USERPROFILE%\.cursor\mcp.json on Windows, or ~/.cursor/mcp.json on Linux.

  2. Paste the JSON config below.

  3. Replace placeholder secrets, then restart the client if it does not reload on its own.

~/.cursor/mcp.json
{  "mcpServers": {    "mattoddie-unifi-mcp": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "ghcr.io/mattoddie/unifi-mcp:0.6.1"      ],      "env": {        "MCP_TRANSPORT": "",        "UNIFI_URL": "",        "UNIFI_API_KEY": "YOUR_UNIFI_API_KEY",        "UNIFI_USERNAME": "",        "UNIFI_PASSWORD": "YOUR_UNIFI_PASSWORD",        "UNIFI_TLS_FINGERPRINT": "",        "UNIFI_VERIFY_SSL": "",        "UNIFI_SITE": "default",        "UNIFI_ALLOW_WRITES": "false",        "UNIFI_ALLOW_DELETES": "false",        "UNIFI_TOOLSETS": "",        "UNIFI_AUDIT_LOG": ""      }    }  }}

Where the config lives

SystemPath
macOS~/.cursor/mcp.json
Windows%USERPROFILE%\.cursor\mcp.json
Linux~/.cursor/mcp.json