UniFi MCP Server
Enables managing UniFi networks through natural language, allowing users to monitor clients, check network health, and perform device actions like blocking or restarting access points. It securely connects UniFi Controllers to MCP clients with features like Google OAuth authentication.
README
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
# 1. Clone and setup
cp .env.example .env
# Edit .env with your credentials (see SETUP.md)
# 2. Start with Docker
docker-compose up -d
# 3. Open http://localhost:3000 and login with Google
See SETUP.md for detailed configuration instructions.
Available Tools
| Tool | Description |
|---|---|
list_clients |
List all connected devices |
get_client |
Get details for a specific client |
search_devices |
Search by name, IP, or MAC |
list_access_points |
List all APs with status |
get_network_health |
Network health statistics |
block_client |
Block a device from the network |
unblock_client |
Unblock a device |
reconnect_client |
Force a client to reconnect |
restart_device |
Restart an AP or switch |
list_blocked_clients |
List blocked devices |
Example Usage
Once connected to Claude:
"List all devices on my network"
"Find any devices with 'iPhone' in the name"
"Block the device with MAC aa:bb:cc:dd:ee:ff"
"Show me the status of all access points"
"Restart the living room AP"
Architecture
Claude Desktop → Cloudflare Tunnel → Docker Container → UniFi Controller
(HTTPS) (Google OAuth) (Local API)
Configuration
Required environment variables:
| Variable | Description |
|---|---|
SESSION_SECRET |
Random secret for sessions |
GOOGLE_CLIENT_ID |
Google OAuth client ID |
GOOGLE_CLIENT_SECRET |
Google OAuth client secret |
ALLOWED_EMAILS |
Comma-separated allowed emails |
UNIFI_HOST |
UniFi controller IP address |
UNIFI_USERNAME |
UniFi admin username |
UNIFI_PASSWORD |
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.