Unifi Mcp Server
Let your coding agent query and manage a UniFi site through the official API without clicking through the controller UI.
Overview
io.github.enuno/unifi-mcp-server is an Operate-phase MCP server that connects AI agents to the official UniFi Controller API for site and device management.
What is this MCP server?
- Stdio MCP server (npm unifi-mcp-server v0.2.0) over the official UniFi Controller API
- Configure controller host, port (default 443), site name (default default), and optional SSL verification
- Requires UNIFI_HOST, UNIFI_USERNAME, and UNIFI_PASSWORD env vars for authenticated API calls
- Fits agent-driven checks on clients, devices, and site state during incidents or change windows
- MCP integration layer—not a UniFi deployment or firewall policy authoring skill
- Server schema version 0.2.0
- npm package identifier unifi-mcp-server with stdio transport
- Five documented environment variables including required host, username, and password
Community signal: 162 GitHub stars.
What problem does it solve?
UniFi changes and troubleshooting still mean logging into the controller or hand-rolling API calls while your agent cannot see live network state.
Who is it for?
Indie builders or consultants who already run a UniFi site and want agent-assisted visibility during debugging, audits, or small config checks.
Skip if: Teams without a UniFi Controller, greenfield network design from scratch, or environments that forbid storing controller passwords in local agent config.
What do I get? / Deliverables
After registration, your agent can use MCP tools backed by your controller credentials to answer UniFi questions and support infra ops from the IDE.
- Registered stdio MCP server wired to your UniFi Controller
- Agent-callable UniFi API access scoped by your site and credentials
- Documented env var set for host, user, password, port, site, and SSL verification
Recommended MCP Servers
Journey fit
Network and site infrastructure for a home lab, studio, or small-office stack is ongoing production operations, not a one-time build task. UniFi covers APs, switches, gateways, and site config—the canonical operate shelf for physical and edge network infra.
How it compares
MCP bridge to UniFi’s official API, not a network design playbook or a generic HTTP scraping skill.
Common Questions / FAQ
Who is unifi-mcp-server for?
Solo builders and small teams who operate a UniFi Controller and want Claude Code, Cursor, or Codex to call the official API through MCP.
When should I use unifi-mcp-server?
Use it during Operate when you need agent-readable UniFi site or device context without leaving your coding workflow.
How do I add unifi-mcp-server to my agent?
Install the npm package unifi-mcp-server, add the stdio MCP server entry, and set UNIFI_HOST, UNIFI_USERNAME, and UNIFI_PASSWORD (plus optional port, site, and SSL flags).