unifi-protect-setup

Configure a UniFi Protect MCP server with host, credentials, and policy variables.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of setting up a UniFi Protect connection so your AI client can access your NVR for discovery and controlled operations.

Core Features & Use Cases

  • Walks through NVR host configuration: Collects the UniFi controller IP/hostname needed to reach UniFi Protect.
  • Stores correct credentials per client: Prompts for a UniFi controller username and password (and optionally an API key) and writes them into the appropriate MCP configuration for your runtime.
  • Applies granular permission policies: Lets you enable read-only or camera/device management write permissions using the expected UNIFI_POLICY_PROTECT_<CATEGORY>_<ACTION>=true variables.
  • Supports Claude Code, Codex, and OpenClaw: Uses the correct setup flow and client-specific write behavior for each runtime.

Quick Start

Tell the Skill your UniFi controller IP/hostname, your local admin username, and your UniFi Protect password, then choose whether to configure read-only or write permissions.

Frequently Asked Questions about unifi-protect-setup

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

FAQPage Schema
How do I connect Claude Code to my UniFi Protect network video recorder?

To connect Claude Code to a UniFi Protect network video recorder, provide your controller IP/hostname, local admin username, and password. The setup script writes these credentials into the appropriate MCP configuration for your runtime.

Can I restrict AI access to read-only operations on my UniFi Protect cameras?

Yes, you can restrict AI access to read-only operations on UniFi Protect cameras. The setup process applies granular permission policies using configurable `UNIFI_POLICY_PROTECT_<CATEGORY>_<ACTION>=true` variables for camera and device management.

Does UniFi Protect MCP integration work with OpenClaw and Codex?

UniFi Protect MCP integration supports Claude Code, Codex, and OpenClaw. The setup flow detects your runtime and applies the correct client-specific configuration values and write behavior for each platform.

How do I configure a UniFi Protect API key for MCP server access?

Configuring a UniFi Protect API key for MCP server access requires providing your controller IP/hostname and credentials. The setup script optionally prompts for an API key and writes it alongside your username and password into the MCP configuration.

What prerequisites are needed to set up a UniFi Protect MCP server?

Setting up a UniFi Protect MCP server requires your UniFi controller host, local admin credentials, and optionally an API key. The setup script runs prerequisite checks first to satisfy safe initialization before writing configuration values.

Why is my UniFi Protect MCP setup not writing the correct permission policies?

UniFi Protect MCP setup writes permission policies by enforcing optional policy variable selection during configuration. Ensure you specify the correct `UNIFI_POLICY_PROTECT_<CATEGORY>_<ACTION>=true` variables for your desired read-only or write access levels.