UniFi Fabric MCP Server — Claude Code MCP server: features and setup
The UniFi Fabric MCP Server MCP server for Claude Code connects an AI assistant to a UniFi network. It can inspect offline devices, investigate Wi-Fi issues, and manage settings.
MIT ★ 6 updated 2026-11-15
claude mcp add --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> --env UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> --env MCP_AUTH_MODE=<MCP_AUTH_MODE> --env MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> --transport stdio unifi-fabric-mcp-server -- uvx unifi-fabric-mcp-serverWhat UniFi Fabric MCP Server does
The server gives an assistant access to UniFi Fabric data and controls for networks, Wi-Fi, VPN, firewall policies, clients, and devices. It also covers Protect cameras and InnerSpace floor plans. Tools load on demand; the full catalog contains 798 tools.
Connect consoles to a fabric through UniFi Site Manager and provide a fabric API key. One key covers an organization, while multiple keys can connect several organizations. Requests go through Ubiquiti's cloud, so the server does not need to reach a controller on the local network.
What it helps with
- find offline UniFi devices
- investigate Wi-Fi problems
- review recent Protect camera events
- locate InnerSpace floor plans
- change network and firewall settings
Example prompts for the agent
- List my UniFi sites and the devices at each one.
- Find offline devices and suggest what to investigate.
- Show recent events from my Protect cameras.
How to install UniFi Fabric MCP Server
Platform CLI
claude mcp add --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> --env UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> --env MCP_AUTH_MODE=<MCP_AUTH_MODE> --env MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> --transport stdio unifi-fabric-mcp-server -- uvx unifi-fabric-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from unifi-fabric-mcp-server <command>
Platform CLI
codex mcp add unifi-fabric-mcp-server --env UNIFI_API_KEY=<UNIFI_API_KEY> --env UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> --env UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> --env MCP_AUTH_MODE=<MCP_AUTH_MODE> --env MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> -- uvx unifi-fabric-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from unifi-fabric-mcp-server <command>
Config file
{
"mcpServers": {
"unifi-fabric-mcp-server": {
"command": "uvx",
"args": [
"unifi-fabric-mcp-server"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_WRITE_POLICY": "<UNIFI_WRITE_POLICY>",
"UNIFI_TOOL_MODE": "<UNIFI_TOOL_MODE>",
"MCP_AUTH_MODE": "<MCP_AUTH_MODE>",
"MCP_BEARER_TOKEN": "<MCP_BEARER_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from unifi-fabric-mcp-server <command>
Config file
{
"servers": {
"unifi-fabric-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"unifi-fabric-mcp-server"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_WRITE_POLICY": "<UNIFI_WRITE_POLICY>",
"UNIFI_TOOL_MODE": "<UNIFI_TOOL_MODE>",
"MCP_AUTH_MODE": "<MCP_AUTH_MODE>",
"MCP_BEARER_TOKEN": "<MCP_BEARER_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from unifi-fabric-mcp-server <command>
Platform CLI
gemini mcp add -e UNIFI_API_KEY=<UNIFI_API_KEY> -e UNIFI_WRITE_POLICY=<UNIFI_WRITE_POLICY> -e UNIFI_TOOL_MODE=<UNIFI_TOOL_MODE> -e MCP_AUTH_MODE=<MCP_AUTH_MODE> -e MCP_BEARER_TOKEN=<MCP_BEARER_TOKEN> unifi-fabric-mcp-server uvx unifi-fabric-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from unifi-fabric-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about UniFi Fabric MCP Server
How do I install UniFi Fabric MCP Server in Claude Code?
Run claude mcp add unifi-fabric-mcp-server -e UNIFI_API_KEY=<UNIFI_API_KEY> -- uvx unifi-fabric-mcp-server and replace the placeholder with a fabric API key.
What does UniFi Fabric MCP Server do?
It connects an AI assistant to UniFi Fabric so it can inspect sites, devices, and Protect events, as well as manage network settings.
What does UniFi Fabric MCP Server need to work?
The consoles must be joined to a fabric through UniFi Site Manager, and a fabric API key must be set as UNIFI_API_KEY. Requests pass through Ubiquiti's cloud.