UniFi Site Manager and Network (unofficial)

io.github.mguttmann/the-real-unifi-mcp

Unofficial MCP server for the UniFi Site Manager and Network cloud APIs, with a write-confirm guard.

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "the-real-unifi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "the-real-unifi-mcp@0.4.0"
      ],
      "env": {
        "UNIFI_API_KEY": "<your UNIFI_API_KEY>",
        "UNIFI_CONFIRM_WRITES": "true",
        "UNIFI_API_BASE": "https://api.ui.com",
        "UNIFI_TIMEOUT_MS": "30000",
        "UNIFI_LOG_LEVEL": "info",
        "UNIFI_READ_ONLY": "false",
        "UNIFI_REDACT_SECRETS": "false",
        "UNIFI_MAX_RESULT_BYTES": "100000"
      }
    }
  }
}
Environment variables
  • UNIFI_API_KEYrequiredsecretUniFi Site Manager API key with Network scope (unifi.ui.com, Settings > API). It controls your whole network: treat it like an admin password.
  • UNIFI_CONFIRM_WRITESWrite confirmation: destructive tools return a preview and run only when called again with confirm "YES". Only false, 0, no or off turn it off.
  • UNIFI_API_BASEAPI base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default.
  • UNIFI_TIMEOUT_MSPer-request timeout in milliseconds, covering response headers and body.
  • UNIFI_LOG_LEVELLog level on stderr: debug, info, warn or error.
  • UNIFI_READ_ONLYRead-only mode: every write tool returns an error and sends no request; reads still work. Off by default.
  • UNIFI_REDACT_SECRETSMasks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default.
  • UNIFI_MAX_RESULT_BYTESCuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.4.0
Registry
active
Published
10/27/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that UniFi Site Manager and Network (unofficial) is listed here — it’s also the link we check for a free listing.

UniFi Site Manager and Network (unofficial) — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mguttmann-the-real-unifi-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="UniFi Site Manager and Network (unofficial) — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![UniFi Site Manager and Network (unofficial) — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mguttmann-the-real-unifi-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.