UniFi Network MCP Server
by sirkirby
A self-hosted Model Context Protocol (MCP) server that turns your UniFi Network Controller into a rich set of programmable tools. It exposes UniFi Network Controller capabilities via standard MCP tools, allowing LLMs or agents to query, analyze, and modify your network (with explicit confirmation).
Last updated: N/A
What is UniFi Network MCP Server?
The UniFi Network MCP Server is a self-hosted server that exposes the UniFi Network Controller's functionalities through the Model Context Protocol (MCP). This allows other applications, especially LLMs and agents, to interact with and manage your UniFi network.
How to use UniFi Network MCP Server?
The server can be deployed using Docker or directly via Python/UV. Configuration is done through environment variables, a .env file, or a config.yaml file. Once running, it exposes MCP tools prefixed with unifi_ that can be accessed via standard MCP clients like Claude Desktop or mcp-cli.
Key features of UniFi Network MCP Server
Full catalog of UniFi controller operations
Mutating tools require confirmation
Works over stdio (FastMCP) and SSE HTTP endpoint
One-liner launch via console script
Idiomatic Python ≥ 3.10
Use cases of UniFi Network MCP Server
Automating network configuration changes
Integrating UniFi network management with LLM-based assistants
Programmatically querying network status and statistics
Creating custom network monitoring and alerting systems
FAQ from UniFi Network MCP Server
What is MCP?
What is MCP?
Model Context Protocol is a standard for exposing application capabilities to LLMs and agents.
How do I configure the server?
How do I configure the server?
Configuration is done through environment variables, a .env file, or a config.yaml file.
How do I prevent accidental changes to my network?
How do I prevent accidental changes to my network?
All state-changing tools require the confirm=true argument.
How do I install the server?
How do I install the server?
You can install the server using Docker, Python/UV, or from PyPI.
How do I use it with Claude Desktop?
How do I use it with Claude Desktop?
Add or update the unifi-network-mcp block under mcpServers in your claude_desktop_config.json.