UniFi MCP Server

MCPOpen SourceMIT34.5

by zcking • APIs & Integration

Local MCP server that exposes UniFi Network API functionality to AI agents for natural-language querying and management of UniFi devices and sites.

Example Use Cases

1
Query UniFi sites and device inventories using natural language.
2
Perform management or control actions on UniFi devices via the UniFi Network API.
3
A local MCP endpoint to integrate with Goose AI or Claude Desktop for network operations and debugging.

Description

This project wraps the UniFi Network API to allow AI agents (e.g., Goose and Claude) to query and control UniFi sites and devices using natural language. It runs locally, authenticates using a UniFi API key, and provides an MCP-compatible interface with an MCP Inspector for testing. The README includes setup and integration instructions for Goose AI and Claude Desktop and shows how to run the server with the uv tool. It is intended to simplify automation, troubleshooting, and management of UniFi networks through conversational agents.

Capabilities(29 total)

Tools (19)

unifi_list_devices

List all UniFi network devices (access points, switches, gateways) with status

unifi_list_clients

List all connected clients. Optionally filter by AP MAC address.

ap_mac:stringlimit:integeroffset:integer

unifi_client_details

Get detailed information about a specific client by MAC address

mac:string*

unifi_events

Get recent network events. Filter by client MAC or event type.

limit:integerclient_mac:stringevent_type:string

unifi_alarms

Get active alarms from the UniFi controller

Prompts (6)

troubleshoot_wifi

Diagnose WiFi connectivity issues for a specific client

client_identifiertimeframe

wifi_audit

Full wireless environment audit across all APs

deployment_assessment

Full network health assessment — devices, switches, wireless, events, and topology with structured findings

focus

switch_health

Deep dive on switch port errors, drop rates, and STP state

switch_mac

capacity_report

AP load analysis — client distribution per band, throughput trends, and capacity headroom

hours

Resources (4)

UniFi Devices

All network devices (APs, switches, gateways) with status

URI: unifi://devicesMIME: application/json

Active Clients

Currently connected wireless and wired clients

URI: unifi://clients/activeMIME: application/json

Site Health

Site health summary for all subsystems

URI: unifi://healthMIME: application/json

Infrastructure Events

Recent non-roam events: device offline, switch connect, channel change, SFP loss

URI: unifi://events/infrastructureMIME: application/json

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

C57/100

6/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities19 Tools / 6 Prompts / 4 Resources

Ownerzcking

CategoryAPIs & Integration

DependenciesStandalone

Set Your Username