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
0

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

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
5.6K
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
6.2K
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
6.4K
5 points
R
Rsdoctor
Rsdoctor is a build analysis tool specifically designed for the Rspack ecosystem, fully compatible with webpack. It provides visual build analysis, multi - dimensional performance diagnosis, and intelligent optimization suggestions to help developers improve build efficiency and engineering quality.
TypeScript
9.3K
5 points
N
Next Devtools MCP
The Next.js development tools MCP server provides Next.js development tools and utilities for AI programming assistants such as Claude and Cursor, including runtime diagnostics, development automation, and document access functions.
TypeScript
10.7K
5 points
T
Testkube
Testkube is a test orchestration and execution framework for cloud-native applications, providing a unified platform to define, run, and analyze tests. It supports existing testing tools and Kubernetes infrastructure.
Go
6.5K
5 points
M
MCP Windbg
An MCP server that integrates AI models with WinDbg/CDB for analyzing Windows crash dump files and remote debugging, supporting natural language interaction to execute debugging commands.
Python
10.5K
5 points
R
Runno
Runno is a collection of JavaScript toolkits for securely running code in multiple programming languages in environments such as browsers and Node.js. It achieves sandboxed execution through WebAssembly and WASI, supports languages such as Python, Ruby, JavaScript, SQLite, C/C++, and provides integration methods such as web components and MCP servers.
TypeScript
9.3K
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
24.2K
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
33.9K
5 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
20.2K
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
72.2K
4.3 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#
31.0K
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
64.0K
4.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
21.0K
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
97.8K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase