Go Unifi MCP
G

Go Unifi MCP

An MCP server for the UniFi network controller that provides an AI assistant access interface to the UniFi infrastructure (including firewall rules and IPv6), supporting both API key and username/password authentication methods.
2 points
7.7K

What is go-unifi-mcp?

go-unifi-mcp is a bridge that connects AI assistants with UniFi network devices. It allows you to manage your UniFi network through natural language or simple commands without logging in to the complex control panel.

How to use go-unifi-mcp?

Simply configure your UniFi controller connection information, then enable this MCP server in Claude Desktop or Claude Code. You can directly ask the AI assistant about network status, device information, and even perform management operations.

Applicable scenarios

Suitable for home users, small business administrators, or any users who use UniFi network devices and want to simplify the management process through an AI assistant. It is especially suitable for daily tasks such as quickly querying network status, device lists, and managing guest networks.

Main features

Complete UniFi API coverage
Supports 242 UniFi operations, covering various aspects such as device management, network configuration, firewall rules, and user management.
Intelligent tool mode
Provides two tool registration modes: Lazy mode (recommended) only registers 3 meta-tools, saving context space; Eager mode registers all tools, suitable for debugging.
Automatic ID resolution
Automatically converts complex IDs returned by the API into readable names, making the response more intuitive and understandable.
Flexible query filtering
Supports field filtering, full-text search, and field projection, allowing you to accurately obtain the required information.
Multi-platform support
Provides binary files, Docker images, Homebrew, and Nix packages, supporting macOS and Linux systems.
IPv6 and firewall rule support
Fully supports IPv6 and v1/v2 firewall rules to meet modern network requirements.
Advantages
Developed based on the official go-unifi library, with comprehensive and stable API coverage
The intelligent tool mode significantly reduces the context occupation of the AI assistant
The automatic ID resolution function makes the response easier to understand
Supports multiple installation methods and is easy to deploy
Continuously updated to follow the evolution of the UniFi controller version
Limitations
Requires a UniFi controller and corresponding access permissions
The update operation uses a read-modify-write process, which is not an atomic operation
Some advanced features may require a technical background for understanding
Currently only supports command-line and AI assistant integration, without an independent GUI

How to use

Get access credentials
Create an API key (recommended) or prepare the administrator account password in the UniFi controller.
Install the server
Choose an installation method suitable for your system, such as using Homebrew, Docker, or directly downloading the binary file.
Configure Claude Desktop
Edit the Claude Desktop configuration file and add the MCP server configuration.
Start using
Restart Claude Desktop. Now you can directly ask the AI assistant questions about the UniFi network.

Usage examples

Quick network status check
When you want to know the overall network status, you can quickly query device information and client connection status.
Guest network management
Create a temporary network for guests or manage existing guest networks.
Device troubleshooting
When there is a problem with a device connection, quickly view its detailed information and connection status.
Batch device management
Perform the same operation on multiple devices, such as restarting, renaming, or reconfiguring.

Frequently Asked Questions

What version of the UniFi controller do I need?
What's the difference between Lazy mode and Eager mode?
Which authentication method is better, API key or username/password?
Why is there an _name field in the response sometimes?
How to filter query results?
Is the update operation safe? Will it overwrite others' modifications?

Related resources

GitHub repository
Project source code, issue tracking, and the latest version
go-unifi library
The UniFi Go client library that this project depends on
UniFi official documentation
Official documentation and support for UniFi network devices
Model Context Protocol
Official specification of the MCP protocol
Docker image
Official Docker image repository

Installation

Copy the following command to your Client for configuration
{
  "mcpServers": {
    "unifi": {
      "command": "/usr/local/bin/go-unifi-mcp",
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNIFI_HOST",
        "-e",
        "UNIFI_API_KEY",
        "ghcr.io/claytono/go-unifi-mcp:latest"
      ],
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
9.6K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
9.1K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
14.9K
5 points
S
Security Detections MCP
Security Detections MCP is a server based on the Model Context Protocol that allows LLMs to query a unified security detection rule database covering Sigma, Splunk ESCU, Elastic, and KQL formats. The latest version 3.0 is upgraded to an autonomous detection engineering platform that can automatically extract TTPs from threat intelligence, analyze coverage gaps, generate SIEM-native format detection rules, run tests, and verify. The project includes over 71 tools, 11 pre-built workflow prompts, and a knowledge graph system, supporting multiple SIEM platforms.
TypeScript
6.7K
4 points
P
Paperbanana
Python
10.0K
5 points
B
Better Icons
An MCP server and CLI tool that provides search and retrieval of over 200,000 icons, supports more than 150 icon libraries, and helps AI assistants and developers quickly obtain and use icons.
TypeScript
8.7K
4.5 points
A
Assistant Ui
assistant - ui is an open - source TypeScript/React library for quickly building production - grade AI chat interfaces, providing composable UI components, streaming responses, accessibility, etc., and supporting multiple AI backends and models.
TypeScript
10.0K
5 points
A
Apify MCP Server
The Apify MCP Server is a tool based on the Model Context Protocol (MCP) that allows AI assistants to extract data from websites such as social media, search engines, and e-commerce through thousands of ready-to-use crawlers, scrapers, and automation tools (Apify Actors). It supports OAuth and Skyfire proxy payment and can be integrated into MCP clients such as Claude and VS Code through HTTPS endpoints or local stdio.
TypeScript
8.9K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
28.5K
4.3 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
24.9K
4.5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
81.7K
4.3 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
38.2K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
69.7K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
37.5K
5 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
24.0K
4.5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
56.5K
4.8 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase