Back to catalog

UniFi (Full Management)

Full UniFi management with 161 tools across every domain

Comprehensive UniFi network management — 161 tools covering devices, clients, networks, firewall, VPN, and system configuration

community v1.5.5 network-v1 npx MIT
Authorsirkirby
Setuptrivial
Authbasic

Service Contract

network

Highlights

⚙️ 161 tools — full network configuration management
🔄 Preview-then-confirm — safe write operations
📋 Claude Code plugin — available as npm package
🔐 TOTP 2FA — built-in support

About

What it does

UniFi (Full Management) wraps the UniFi controller API as 161 MCP tools covering the complete network management surface: devices, clients, networks, VLANs, firewall rules, VPN, port forwarding, DPI, and system configuration.

This is the most comprehensive UniFi MCP available — it exposes nearly every controller API endpoint as a callable tool.

How it works

The plugin connects directly to your UniFi controller (UDM, UDR, Cloud Key, or self-hosted) via its local API. Authentication uses a local admin account with optional TOTP 2FA support.

Write operations use a preview-then-confirm pattern: the plugin shows what will change before applying it, preventing accidental network misconfigurations.

Safety considerations

With 161 tools covering firewall rules, VLANs, and system settings, misconfiguration can disrupt your entire network. The preview-then-confirm pattern mitigates this, but careful review of write operations is essential.

When to use this vs ubiquiti-unifi-blade-mcp

  • This plugin — when you need to create networks, configure VLANs, edit firewall rules, or manage system settings
  • ubiquiti-unifi-blade-mcp (certified) — when you need read-only monitoring, client tracking, and security visibility with token-efficient output

Community plugin

This is a community-contributed plugin wrapping sirkirby/unifi-mcp. It is not maintained by Sidereal or Ubiquiti.

Conformance

Requireduntested
Recommendeduntested
Optionaluntested

Setup

Enter your UniFi controller credentials. This MCP provides full management capability including network creation, VLAN configuration, and system settings.

UNIFI_HOST Controller Host required
UNIFI_USERNAME Username required
UNIFI_PASSWORD Password required secret

Prerequisites

  • UniFi controller (UDM, UDR, Cloud Key, or self-hosted)
  • Local admin account on the controller
  • Node.js runtime

Scenarios

Pair with ubiquiti-unifi-blade-mcp

Both use network. Ubiquiti UniFi network monitoring and security — device health, client visibility, firewall policies, traffic routes, DPI restrictions, and port forwards.

network
Build a network workflow

Use the Forge to design an automation pack powered by unifi-mcp for network operations.

Install

sidereal install unifi-mcp