Advertise
MCP.so
Sign In

UniFi Network MCP Server

@sirkirby

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

sirkirby

About UniFi Network MCP Server

MCP server implementation for the UniFi network application

#unifi#mcp-server

UniFi Network MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unifi-network-mcp": {
      "command": "docker",
      "args": [
        "pull",
        "ghcr.io/sirkirby/unifi-network-mcp:latest"
      ]
    }
  }
}

UniFi Network MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is UniFi Network MCP Server?

A self-hosted Model Context Protocol (MCP) server that turns your UniFi Network Controller into a programmable set of tools. It exposes every capability as standard MCP tools prefixed with unifi_, so any LLM or agent speaking MCP (e.g., Claude Desktop, mcp-cli, LangChain) can query, analyse, and – when explicitly confirmed – modify your network.

How to use UniFi Network MCP Server?

Run via Docker using ghcr.io/sirkirby/unifi-network-mcp:latest, or install locally with Python/UV (uv pip install unifi-network-mcp) then launch the mcp-server-unifi-network command. Supply UniFi controller credentials through environment variables (UNIFI_HOST, UNIFI_USERNAME, UNIFI_PASSWORD, etc.) or an .env file. Integrate with Claude Desktop by adding the server to your claude_desktop_config.json.

Key features of UniFi Network MCP Server

  • Full catalog of UniFi controller operations (firewall, traffic-routes, port-forwards, QoS, VPN, WLANs, stats, devices, clients).
  • All mutating tools require confirm=true to prevent accidental changes.
  • Works over stdio (FastMCP) and exposes an SSE HTTP endpoint (default port 3000).
  • One-liner launch via the console-script mcp-server-unifi-network.
  • Python ≥ 3.10, packaged with pyproject.toml and available on PyPI.

Use cases of UniFi Network MCP Server

  • Query and analyse network statistics, device lists, and client activity through natural language.
  • Create, update, or toggle firewall policies and port forwards with explicit user confirmation.
  • Block/unblock clients, rename devices, and reboot equipment via an LLM agent.
  • Automate VPN client and server configuration changes.
  • Retrieve alerts and network health without logging into the controller UI.

Frequently asked questions

1

What does this server do vs alternatives?

It is an MCP server, not a UniFi controller. It translates MCP tool calls into UniFi controller API operations, enabling any MCP-compatible LLM or agent to interact with your network.

2

What are the runtime requirements?

You need either Docker (to run the pre-built image) or Python ≥3.10 with `uv`/`pip`. The server must be able to reach a UniFi Network Controller over HTTPS.

3

Where does my network data live?

All data remains in the UniFi controller. The server acts as a pass-through and does not store any network configuration or client data.

4

Which transport protocols are supported?

The server supports both **stdio** (default for MCP) and **SSE HTTP** (on port 3000 by default). Configuration is set in `src/config/config.yaml`.

5

How do I authenticate to the UniFi controller?

Credentials are supplied via environment variables (`UNIFI_HOST`, `UNIFI_USERNAME`, `UNIFI_PASSWORD`, `UNIFI_PORT`, `UNIFI_SITE`, `UNIFI_VERIFY_SSL`) or an `.env` file. No additional authentication layer is provided for the MCP transport.

Comments

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise