Skip to main content
Glama
CamoRageaholic1

UniFi Network MCP Server

UniFi Network MCP Server

A comprehensive Model Context Protocol (MCP) server providing programmatic access to UniFi Network Controller APIs. Enables AI assistants like Claude to manage and monitor UniFi network infrastructure through natural language.


🚀 Quick Start

# 1. Clone and install
git clone https://github.com/CamoRageaholic1/unifi-mcp-server
cd unifi-mcp-server
npm install

# 2. Configure
cp .env.example .env
# Edit .env with your UniFi credentials

# 3. Build and run
npm run build
npm start

Related MCP server: UniFi Network MCP Server

✨ Features

46 Management Tools Across 9 Categories

  • 📱 Device Management (13 tools): List, restart, adopt, upgrade devices, control ports & PoE

  • 👥 Client Management (9 tools): Block/unblock, bandwidth limits, friendly names

  • 🌐 WiFi Management (6 tools): Configure SSIDs, passwords, security

  • 🔧 Network & VLAN (4 tools): Create VLANs, configure DHCP

  • 🔥 Firewall (2 tools): Create rules, filter traffic

  • 🌍 Port Forwarding (4 tools): Create/enable/disable forwards

  • 📈 Monitoring (5 tools): System health, statistics, alerts

  • ⚙️ Site Management (2 tools): Backups, site info

  • 🔌 Switch Port Control: Per-port and PoE management


📋 Installation

See QUICKSTART.md for 5-minute setup guide.

Requirements

  • Node.js 18+ (20 LTS recommended)

  • UniFi Network Controller (any version with API support)

  • Network access to controller


💬 Example Commands

"List all my UniFi devices"
"Turn off PoE on port 8"
"Change guest WiFi password to Welcome2024"
"Create VLAN 20 for IoT devices"
"Block client aa:bb:cc:dd:ee:ff"
"Show system health"

📚 Documentation


🔒 Security

  • Environment-based configuration (no hardcoded credentials)

  • SSL/TLS verification support

  • Docker secrets compatible

  • Comprehensive security documentation


📄 License

MIT License - See LICENSE file

Created by: CamoZeroDay


⭐ Star this repo if it helps you!

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to manage and monitor UniFi Network Controllers through natural language. Provides 25 read-only tools for discovering devices and clients, viewing security configurations, analyzing network statistics, and exporting configuration data.
    41
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to manage UniFi network infrastructure through 50+ tools covering devices, clients, networks, WiFi, firewall rules, and guest access using the official UniFi Network API.
    52
    50
    5
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Provides AI assistants with access to UniFi Network and Protect infrastructure for managing devices, monitoring clients, analyzing network health, viewing camera snapshots, and getting optimization recommendations across multiple UniFi controllers.
    2
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to manage UniFi Network, Protect, and Access infrastructure through MCP tools, with support for local controllers and cloud relay.
    MIT