UniFi Gateway MCP Server

Safety-first MCP server for self-hosted UniFi. Dry-run previews, JSONL audit log, composite rollback. Network + Protect + Access.

People who need cloud infrastructure tools inside Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-25 · ★ 20 · #91 OF 141 MAINTAINED CLOUD INFRASTRUCTURE · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install UniFi Gateway

before you install - you'll need

Set MCP_UNIFI_TOKEN, STUB_MODE, MCP_UNIFI_AUTH_TOKENS, MCP_UNIFI_AUTH_REQUIRED, UNIFI_HOST, UNIFI_API_KEY before connecting.

Docker

docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.21.1

Claude Desktop - add to config

{
  "mcpServers": {
    "pete-builds-mcp-unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pete-builds/mcp-unifi:0.21.1"
      ]
    }
  }
}

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

registry namespace io.github.pete-builds is GitHub-verified and matches the repo owner

03 · What UniFi Gateway can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.21.1 · 2026-08-16

Fixed · Restored the Python 3.13 base image. A Dependabot digest bump had carried · the Dockerfile FROM tag from python:3.13-slim to python:3.14-slim, and · the deployed container was running Python 3.14.7. Every other…

mcp-unifi-0.2.6 · 2026-08-16

MCP server for self-hosted UniFi gateway management (Network + Protect + Access)

v0.21.0 · 2026-08-13

Added · Read-only mode (MCP_UNIFI_READONLY). Set it to true and the server · becomes structurally unable to change anything: every mutating tool is · dropped from tools/list and refused on tools/call. Both halves ship…

04 · Who maintains UniFi Gateway

UniFi Gateway is maintained by pete-builds. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/pete-builds/mcp-unifi
website: https://pete-builds.github.io/mcp-unifi/
category: cloud infrastructure - ranked #91 of 141 actively-maintained cloud infrastructure servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-16)
registry: io.github.pete-builds/unifi (active, first published 2026-05-09 · 19 versions)
packages: oci:ghcr.io/pete-builds/mcp-unifi:0.21.1

06 · UniFi Gateway FAQ

What is UniFi Gateway?

Safety-first MCP server for self-hosted UniFi. Dry-run previews, JSONL audit log, composite rollback. Network + Protect + Access.

Is UniFi Gateway still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-25 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install UniFi Gateway?

Run `docker run -i --rm ghcr.io/pete-builds/mcp-unifi:0.21.1`. The README documents 6 environment variables (MCP_UNIFI_TOKEN, STUB_MODE, MCP_UNIFI_AUTH_TOKENS…) to set first. Set MCP_UNIFI_TOKEN, STUB_MODE, MCP_UNIFI_AUTH_TOKENS, MCP_UNIFI_AUTH_REQUIRED, UNIFI_HOST, UNIFI_API_KEY before connecting. You can also paste the ready-made client config above.

07 · Alternatives to UniFi Gateway

Alternatives to UniFi Gateway

Maintained cloud infrastructure servers if UniFi Gateway isn't the fit.

Pairs well with

Servers that cover what UniFi Gateway doesn't - only shown when the pairing reason fits the companion.

More cloud infrastructure MCP servers · OWASP ZAP MCP Server · AINumbers Fintech Intelligence Suite · Audiolla · Claudebox · Hybrid S3

More Python MCP servers · Oncofiles · CallRail MCP · Palinode · Anneal Memory · Bolor Brain MCP · see all