---

name: unifi description: Manage Ubiquiti UniFi networks - monitor devices, clients, health status, restart APs, block/unblock clients. Use when user mentions UniFi, network management, or WiFi issues. triggers:

• UniFi network management
• WiFi client monitoring
• Network device control
• Access point management
• Network health check

---

UniFi MCP Server

Manage Ubiquiti UniFi networks from Claude Code via MCP.

When to Use

Use this skill when:

• User asks about network devices or clients
• User wants to check network health or status
• User needs to restart an access point or device
• User wants to block/unblock network clients
• User mentions "UniFi", "WiFi", "network", or related terms

Available MCP Tools

Monitoring Tools

Management Tools

Common Workflows

Check Network Health

Copy1. Use get_network_health() for overall status
2. Use list_alerts() to see recent issues
3. Use list_devices() to check device states

Find and Manage Clients

Copy1. Use list_clients() to see all connected devices
2. Filter by "wireless" or "wired" if needed
3. Use block_client(mac) to block a problematic device

Troubleshoot an AP

Copy1. Use list_devices("ap") to see access points
2. Use get_device_stats(mac) for detailed info
3. Use restart_device(mac) if restart is needed

Authorize Guest

Copy1. Get guest's MAC address
2. Use authorize_guest(mac, minutes, up_kbps, down_kbps)
3. Default is unlimited if no limits specified

Version Selection

The UNIFI_VERSION setting depends on your hardware:

Troubleshooting

SSL Errors

Self-signed certificate errors are handled automatically (ssl_verify=False).

Authentication Errors

1. Verify credentials: deep-env list | grep UNIFI
2. Ensure UniFi user has admin privileges
3. Try changing UNIFI_VERSION if commands fail

Commands Failing

If commands fail silently, try a different UNIFI_VERSION setting.

Setup

Store credentials via deep-env:

Copydeep-env store UNIFI_HOST "your-controller-ip"
deep-env store UNIFI_USERNAME "your-username"
deep-env store UNIFI_PASSWORD "your-password"
deep-env store UNIFI_VERSION "UDMP-unifiOS"

Example Usage

Check devices: "What devices are on my network?"

See wireless clients: "Show me all wireless clients"

Restart an AP: "Restart the living room AP"

Block a device: "Block the device with MAC aa:bb:cc:dd:ee:ff"

Network health: "What's the network health status?"