unifi-network-setup

Configure UniFi Network controller access for MCP clients.

1|Updated Apr 6, 2025
One-click install
npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill unifi-network-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unifi-network-setup
Source: https://github.com/david-driscoll/stargate-command-cluster/tree/main/.agents/skills/unifi-network-setup
Command: npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill unifi-network-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of manually wiring up UniFi Network controller access so your AI client can use UniFi functionality without misconfiguration or missing permissions.

Core Features & Use Cases

  • Guided controller setup: Collects the UniFi controller host plus credentials from the user, one step at a time.
  • Optional API key support: Helps the user decide whether to configure an experimental, read-oriented UniFi API key mode.
  • Permission policy configuration: Lets you choose read-only access or progressively enable common write capabilities (e.g., firewall, port forwards, QoS) using explicit policy variables.
  • Writes client-specific MCP config: Updates the correct local MCP server configuration for Claude Code, Codex, or OpenClaw.

Quick Start

Configure the unifi-network-setup skill for Claude Code, Codex, or OpenClaw by answering the prompts for controller host, username, and password.

Frequently Asked Questions about unifi-network-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure UniFi Network controller access for Claude Code?

To configure UniFi Network controller access for Claude Code, you provide the controller host and credentials through an interactive setup process that writes the resulting environment variables to the correct local MCP server configuration file.

Can I restrict MCP server permissions to read-only UniFi API access?

Yes, you can restrict MCP server permissions to read-only UniFi API access by selecting a read-only permission policy during setup, or progressively enable specific write capabilities like firewall, port forwards, and QoS using explicit policy variables.

Does UniFi MCP setup support API key mode for network automation?

Yes, UniFi MCP setup supports an optional, experimental API key mode for network automation, allowing you to configure read-oriented API key access instead of standard username and password authentication.

What is the best way to write UniFi controller credentials to different MCP clients?

The best way to write UniFi controller credentials to different MCP clients is using target-aware setup logic that detects whether you are using Claude Code, Codex, or OpenClaw and updates the corresponding local configuration automatically.

Do I need to run prerequisite checks before setting up UniFi Network MCP?

Yes, you need to run prerequisite checks before setting up UniFi Network MCP by executing the check-prereqs.sh script, which verifies your environment is ready before running the target-aware set-env.sh configuration script.

How does UniFi MCP setup handle environment variables on Windows?

On Windows, UniFi MCP setup handles environment variables by using platform-specific MCP commands instead of the set-env.sh script, ensuring the controller host and credentials are written correctly to the Windows client configuration.