unifi-mcp

Overview

UniFi MCP is a collection of MCP servers that enable AI assistants to interact with Ubiquiti UniFi controllers. The project includes three main servers: Network (stable, 169 tools), Protect (beta, 43 tools), and Access (beta, 29 tools). Each server exposes its respective UniFi application functionality as MCP tools that are queryable, composable, and safe by default. The project also includes a cloud relay for connecting to remote agents and an optional REST/GraphQL API for non-MCP consumers.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• show_clients

  Show all clients connected to the network with their details

  Try:Show me all clients on the Guest VLAN with their signal strengthTry:List all connected devices with their data usage
• create_firewall_rule

  Create a new firewall rule to control network traffic

  Try:Create a firewall rule that blocks IoT devices from reaching the internet between midnight and 6 AMTry:Add a rule to allow management traffic only during business hours
• audit_firewall

  Audit firewall policies for redundant or conflicting rules

  Try:Audit my firewall policies — are there any redundant or conflicting rules?Try:Check for overlapping firewall rules that might cause security issues
• list_motion_cameras

  List all cameras that detected motion in a specified time period

  Try:List all cameras that detected motion in the last hourTry:Show me cameras with motion detection from yesterday
• show_smart_detection

  Show smart detection events from cameras with filtering options

  Try:Show me smart detection events from the front door camera today — people and vehicles onlyTry:List all person detection events from the back camera
• badge_access_events

  Show timeline of door access events and badge information

  Try:Who badged into the office today? Show me a timeline of all door access eventsTry:List all access events from the main entrance yesterday
• create_visitor_pass

  Create a visitor pass with specific access permissions

  Try:Create a visitor pass for John Smith with access to the main entrance tomorrow 9-5Try:Generate a temporary badge for the conference room with 24-hour access
• network_health_check

  Run batch diagnostics across devices and health subsystems

  Try:Run a network health check on all switchesTry:Check the status of all access points and their connections
• firewall_manager

  Manage firewall policies with templates and change tracking

  Try:Apply the IoT security template to my firewall rulesTry:Create a backup of my current firewall configuration
• security_digest

  Summarize cross-product events with severity classification

  Try:Generate a security digest for yesterday's eventsTry:Show me all high-severity events from cameras and doors
• correlate_events

  Correlate Network, Protect, and Access events in a single timeline

  Try:Show me everything that happened at the front entrance in the last hourTry:What network events occurred when the door was opened at 2 AM?
• audit_firewall_policies

  Comprehensive security audit of firewall policies with scoring

  Try:Perform a security audit of my firewall policiesTry:Check my firewall configuration against best practices

Comparable tools

Installation

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": ["unifi-network-mcp@latest"],
      "env": {
        "UNIFI_HOST": "192.168.1.1",
        "UNIFI_USERNAME": "admin",
        "UNIFI_PASSWORD": "your-password"
      }
    },
    "unifi-protect": {
      "command": "uvx",
      "args": ["unifi-protect-mcp@latest"],
      "env": {
        "UNIFI_PROTECT_HOST": "192.168.1.1",
        "UNIFI_PROTECT_USERNAME": "admin",
        "UNIFI_PROTECT_PASSWORD": "your-password"
      }
    },
    "unifi-access": {
      "command": "uvx",
      "args": ["unifi-access-mcp@latest"],
      "env": {
        "UNIFI_ACCESS_HOST": "192.168.1.1",
        "UNIFI_ACCESS_USERNAME": "admin",
        "UNIFI_ACCESS_PASSWORD": "your-password"
      }
    }
  }
}

uvx unifi-network-mcp@latest
uvx unifi-protect-mcp@latest
uvx unifi-access-mcp@latest

FAQ

Does this require UniFi API keys?

No, it uses username/password authentication by default. API keys are optional and experimental, limited to read-only access.

Can I manage multiple controllers with this?

Yes, each server supports prefixed environment variables to connect to different controllers or use different credentials.

What's the preview-then-confirm flow?

Before applying any changes, the MCP tools show you exactly what will be modified, allowing you to confirm or reject changes before they take effect.

Compare unifi-mcp with