MCP Server UniFi

by zcking

MCP Server UniFi

A server implementation for managing and controlling UniFi network devices through MCP (Management Control Protocol). This server enables natural language interactions with your UniFi network using AI agents like Goose and Claude by wrapping the UniFi Network API.

Features

  • Query UniFi sites and devices using natural language through AI agents
  • Local server implementation that connects to your UniFi Network application
  • Compatible with both Goose AI and Claude Desktop
  • Secure API key-based authentication

Prerequisites

  • Python 3.8 or higher
  • uv package manager
  • UniFi Network application
  • UniFi API key (obtained from UniFi console)

Setup

  1. Create an API key:
    • Go to your UniFi console at https://unifi.ui.com
    • Navigate to Settings » Control Plane » Integrations
    • Click "Create API Key"
  2. Clone and set up the repository:
git clone https://github.com/zcking/mcp-server-unifi cd mcp-server-unifi uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows
  1. Install dependencies:
uv sync
  1. Configure environment variables:
export UNIFI_API_KEY="your_api_key_here"

Running the Server

Start the MCP development server:

uv run mcp dev main.py

The MCP Inspector will be available at http://localhost:5173 for testing and debugging.

AI Agent Integration

Goose AI Setup

  1. Open Goose and go to Settings » Extensions » Add custom extension
  2. Configure the extension:
    • ID: unifi
    • Name: unifi
    • Description: Get information about your UniFi network
    • Command: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
    • Environment Variables: Set UNIFI_API_KEY to your API key

Claude Desktop Setup

  1. Open Claude and go to Settings » Developer » Edit Config
  2. Add to your claude_desktop_config.json:
{ "mcpServers": { "unifi": { "command": "/Users/username/.local/bin/uv", "args": [ "--directory", "/path/to/mcp-server-unifi", "run", "main.py" ] } } }
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A server implementation that enables natural language interactions with UniFi network devices by wrapping the UniFi Network API for AI agents like Goose and Claude.

  1. Features
    1. Prerequisites
      1. Setup
        1. Running the Server
          1. AI Agent Integration
            1. Goose AI Setup
            2. Claude Desktop Setup

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            This server facilitates the invocation of AI models from providers like Anthropic, OpenAI, and Groq, enabling users to manage and configure large language model interactions seamlessly.
            Last updated -
            4
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
            Last updated -
            9
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.
            Last updated -
            203
            MIT License
          • -
            security
            A
            license
            -
            quality
            This server implementation allows AI assistants to interact with Asana's API, enabling users to manage tasks, projects, workspaces, and comments through natural language requests.
            Last updated -
            65
            TypeScript
            MIT License

          View all related MCP servers

          ID: 8l0hwi11sk