sevaepsteyn/unifi_network_api_mcp

UniFi Network API MCP Server

seva@sevatech.com

A Model Context Protocol (MCP) server that provides access to UniFi Network Controller API functionality.

Demo

Available Tools

Read Operations

• application_info() - Get application version info
• sites() - List all sites
• devices(site_id) - List devices in a site
• device_details(site_id, device_id) - Get device details
• device_statistics(site_id, device_id) - Get device statistics
• clients(site_id) - List connected clients
• client_details(site_id, client_id) - Get client details
• vouchers(site_id) - List hotspot vouchers

Write Operations

Device Management

• restart_device(site_id, device_id) - Restart a device
• power_cycle_port(site_id, device_id, port_idx) - Power cycle a PoE port
• search_devices(site_id, name_pattern, model, state) - Search devices with filters

Guest Management

• authorize_guest(site_id, client_id, ...) - Authorize guest access with optional limits
• unauthorize_guest(site_id, client_id) - Revoke guest access

Voucher Management

• create_vouchers(site_id, name, time_limit_minutes, ...) - Create hotspot vouchers
• delete_voucher(site_id, voucher_id) - Delete a voucher

Installation

From Source

# Clone the repository
git clone https://github.com/yourusername/unifi_network_api_mcp.git
cd unifi_network_api_mcp

# Using uv (recommended)
uv sync

Configuration

Set the following environment variables:

# Required
export UNIFI_CONTROLLER_URL="https://your-controller.unifi-hosting.ui.com"
export UNIFI_API_KEY="your-api-key-here"

# Optional
export UNIFI_API_TIMEOUT=30.0
export UNIFI_API_RETRY_ATTEMPTS=3
export UNIFI_API_RETRY_DELAY=1.0
export UNIFI_DEFAULT_PAGE_SIZE=25
export UNIFI_LOG_LEVEL="INFO"

You can also create a .env file in your project root:

UNIFI_CONTROLLER_URL=https://your-controller.unifi-hosting.ui.com
UNIFI_API_KEY=your-api-key-here

Usage

Running the Server

# Using uv (if installed from source)
uv run unifi-network-api-mcp

Using with Claude Desktop

Add MCP server to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

Using uv

{
  "mcpServers": {
    "unifi": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/unifi_network_api_mcp",
        "unifi-network-api-mcp"
      ],
      "env": {
        "UNIFI_CONTROLLER_URL": "https://your-controller.unifi-hosting.ui.com",
        "UNIFI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Development

Setup

# Clone the repository
git clone https://github.com/sevaepsteyn/unifi_network_api_mcp.git
cd unifi_network_api_mcp

# Install dependencies with uv
uv sync

# Run in development mode
uv run unifi-network-api-mcp

# Or use uv with --project from any directory
uv run --project /path/to/unifi_network_api_mcp unifi-network-api-mcp

Testing

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov=unifi_network_api_mcp

API Reference

For detailed API documentation, see .

License

MIT License - see LICENSE file for details