jmagar/unifi-mcp
5 stars · Last commit 2026-04-15
UniFi network management via MCP tools. Monitor devices, clients, network health, firewall rules, and perform management operations.
README preview
# UniFi MCP <!-- mcp-name: tv.tootie/unifi-mcp --> [](https://pypi.org/project/unifi-mcp/) [](https://github.com/jmagar/unifi-mcp/pkgs/container/unifi-mcp) FastMCP server for local UniFi controller management. Exposes a single `unifi` action router and a `unifi_help` reference tool covering devices, clients, network configuration, and controller monitoring. ## Overview The server connects to a self-hosted UniFi controller (including UDM Pro) and proxies all operations through a single MCP tool. A unified action parameter replaces 31 individual tools while preserving every capability. Destructive operations require explicit confirmation. Bearer token auth protects the HTTP endpoint in production. ## What this repository ships - `unifi_mcp/`: server, client, config, formatters, models, services, resources, and tools - `skills/unifi/`: client-facing skill - `docs/`: API notes, action-pattern rationale, testing notes - `.claude-plugin/`, `.codex-plugin/`, `gemini-extension.json`: client manifests - `docker-compose.yaml`, `Dockerfile`: container deployment - `tests/`: unit, resource, and integration tests