UniFi MCP Server

MCP server for UniFi Network Controller - manage your network with AI assistants using natural language.

Features

25 read-only tools across 4 categories:

Quick Start

1. Install

# Using uvx (recommended)
uvx --from git+https://github.com/MidwestMountaineer/Unifi-MCP-Server.git unifi-mcp-server

# Or pip
pip install git+https://github.com/MidwestMountaineer/Unifi-MCP-Server.git

2. Get API Key

1. Log into your Dream Machine

2. Settings → System → Advanced → API

3. Create new API key with Read Only permissions

4. Copy the key (shown only once)

3. Configure

Add to your MCP client config (e.g., .kiro/settings/mcp.json):

{
  "mcpServers": {
    "unifi": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/MidwestMountaineer/Unifi-MCP-Server.git", "unifi-mcp-server"],
      "env": {
        "UNIFI_HOST": "192.168.1.1",
        "UNIFI_API_KEY": "your-api-key-here",
        "UNIFI_VERIFY_SSL": "false"
      }
    }
  }
}

4. Test

Ask your AI assistant: "List all my UniFi devices"

Kiro Power

This repo is also a Kiro Power with guided workflows. Install via Kiro's "Add power from GitHub":

https://github.com/MidwestMountaineer/Unifi-MCP-Server

See POWER.md for workflow documentation.

Configuration

Available Tools

Discovery

• unifi_list_devices / unifi_get_device_details

• unifi_list_clients / unifi_get_client_details

• unifi_list_networks / unifi_get_network_details

• unifi_list_wlans / unifi_get_wlan_details

Security

• unifi_list_firewall_rules / unifi_get_firewall_rule_details

• unifi_list_traffic_routes / unifi_get_route_details

• unifi_list_port_forwards / unifi_get_port_forward_details

• unifi_get_ips_status

Statistics

• unifi_get_network_stats / unifi_get_system_health

• unifi_get_client_stats / unifi_get_device_stats

• unifi_get_top_clients / unifi_get_dpi_stats

• unifi_get_alerts

Migration

• unifi_get_dhcp_status

• unifi_verify_vlan_connectivity

• unifi_export_configuration

Docker

docker-compose up -d

See docs/DOCKER.md for details.

Development

# Clone and install
git clone https://github.com/MidwestMountaineer/Unifi-MCP-Server.git
cd Unifi-MCP-Server
pip install -e ".[dev]"

# Run tests
pytest

# Dev console
python devtools/dev_console.py

Troubleshooting

License

MIT - See LICENSE