Skip to main content
Glama
UniFi Network MCP Server

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 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!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
    • F
      license
      Not graded
      quality
      D
      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
      D
      maintenance
      Enables AI assistants to manage UniFi Network, Protect, and Access infrastructure through MCP tools, with support for local controllers and cloud relay.
      MIT