Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UniFi MCP ServerList all connected devices and check the overall network health"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UniFi MCP Server
A Model Context Protocol server for managing UniFi networks through Claude or other MCP clients.
Features
Network Monitoring - List clients, access points, and network health
Device Management - Block/unblock devices, restart APs, force reconnections
Search - Find devices by name, IP, or MAC address
Secure Access - Google OAuth authentication with email allowlisting
Remote Ready - Designed for access via Cloudflare Tunnel
Quick Start
See SETUP.md for detailed configuration instructions.
Available Tools
Tool | Description |
| List all connected devices |
| Get details for a specific client |
| Search by name, IP, or MAC |
| List all APs with status |
| Network health statistics |
| Block a device from the network |
| Unblock a device |
| Force a client to reconnect |
| Restart an AP or switch |
| List blocked devices |
Example Usage
Once connected to Claude:
Architecture
Configuration
Required environment variables:
Variable | Description |
| Random secret for sessions |
| Google OAuth client ID |
| Google OAuth client secret |
| Comma-separated allowed emails |
| UniFi controller IP address |
| UniFi admin username |
| UniFi admin password |
Tech Stack
Node.js 22 with ES Modules
@modelcontextprotocol/sdk v1.25+
node-unifi v2.5+
Express.js with Passport (Google OAuth)
Docker with Alpine Linux
License
MIT