unifi-protect

Retrieve UniFi Protect camera events, smart detections, and snapshots via MCP server.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps users quickly understand camera activity and manage UniFi Protect hardware actions (like snapshots, detections, and—when explicitly enabled—recording, lights, and alarm state) without manually navigating the Protect UI.

Core Features & Use Cases

  • Real-time and historical awareness: Retrieve recent events from the websocket buffer and query historical events and smart detections for a time range.
  • Camera intelligence and evidence capture: List cameras, pull detailed camera state, fetch snapshots (including inline images), and get RTSP stream URLs for playback.
  • Hardware operations with guardrails: Perform mutations (camera settings/recording/PTZ zoom, lights, chimes, alarm arming/disarming, Known Faces updates/merges/deletes) only when explicit opt-in env vars enable write permissions, using a preview-then-confirm flow.

Quick Start

Ask the AI to list the newest smart detections and include a snapshot for the relevant camera.

Frequently Asked Questions about unifi-protect

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

FAQPage Schema
How do I retrieve UniFi Protect camera snapshots and smart detections for recent security events?

You can retrieve UniFi Protect camera snapshots and smart detections by querying recent events from the websocket buffer or specifying a historical time range. The skill fetches inline image snapshots and detailed detection data without manual UI navigation.

What do I need to connect to a UniFi Protect MCP server and manage my cameras?

You need a UniFi Protect MCP server with your host address and admin credentials to connect and manage cameras. This setup allows the skill to retrieve events, list cameras, and fetch RTSP stream URLs for playback.

Can I control UniFi Protect hardware settings like PTZ zoom, lights, and alarm arming?

Yes, you can control UniFi Protect hardware settings including PTZ zoom presets, lights, chimes, and alarm arming. Mutations require explicit opt-in environment variables to enable write permissions and use a preview-then-confirm flow for safety.

How does the safety model work when managing alarm states and Known Faces?

The safety model gates all mutations behind explicit opt-in environment variables that enable write permissions. Changes to alarm states and Known Faces updates, merges, or deletes follow a preview-then-confirm flow to prevent unintended hardware modifications.

What's the best way to review who or what was detected by my UniFi Protect cameras?

The best way to review detections is to ask the AI to list the newest smart detections and include a snapshot for the relevant camera. This retrieves real-time event data, smart detection details, and inline image evidence quickly.

Why can't I make changes to my UniFi Protect camera recording settings or chimes?

You cannot make changes to recording settings or chimes because all hardware mutations are disabled by default. You must explicitly set opt-in environment variables to enable write permissions before the preview-then-confirm flow allows any modifications.