How do I use UniFi Protect MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@UniFi Protect MCP show me a snapshot from the driveway camera" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

UniFi Protect MCP

by owine

Overview Schema Related Servers Score Discussions

TypeScript

Remote

UniFi Protect MCP Server

An MCP (Model Context Protocol) server that exposes UniFi Protect's Integration REST API as tools for Claude Code and other MCP clients. Aligned with UniFi Protect API 7.1.60 — 73 tools covering cameras, lights, sensors, chimes, viewers, sirens, fobs, relays, speakers, bridges, link stations, alarm hubs, arm profiles, live views, files, users, NVR status, and WebSocket subscriptions.

Prerequisites

Node.js 20+
A UniFi Protect system with the Integration API enabled
An API key generated from your UniFi Protect console

Related MCP server: UniFi MCP Server

Setup

Quick start (npx)

Add to Claude Code with a single command — no clone or build needed:

claude mcp add-json unifi-protect '{"command":"npx","args":["-y","@owine/unifi-protect-mcp@latest"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_API_KEY":"your-api-key","UNIFI_PROTECT_VERIFY_SSL":"false"}}' -s user

Use -s user for global availability across all projects, or -s project for the current project only.

From source

If you prefer to build locally:

git clone https://github.com/owine/unifi-protect-mcp.git
cd unifi-protect-mcp
npm install
npm run build

Then add to Claude Code:

claude mcp add-json unifi-protect '{"command":"node","args":["/path/to/unifi-protect-mcp/dist/index.js"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_API_KEY":"your-api-key","UNIFI_PROTECT_VERIFY_SSL":"false"}}' -s user

Environment Variables

Variable	Required	Default	Description
`UNIFI_PROTECT_HOST`	Yes	—	IP or hostname of your UniFi Protect console
`UNIFI_PROTECT_API_KEY`	Yes	—	API key from Protect integration settings
`UNIFI_PROTECT_VERIFY_SSL`	No	`true`	Set to `false` to skip TLS certificate verification (needed for self-signed certs)
`UNIFI_PROTECT_READ_ONLY`	No	`true`	Set to `false` to enable write/mutating tools (default is monitoring-only mode)

Manual Configuration

Alternatively, add to your ~/.claude.json under the top-level "mcpServers" key:

{
  "mcpServers": {
    "unifi-protect": {
      "command": "npx",
      "args": ["-y", "@owine/unifi-protect-mcp@latest"],
      "env": {
        "UNIFI_PROTECT_HOST": "192.168.1.1",
        "UNIFI_PROTECT_API_KEY": "your-api-key",
        "UNIFI_PROTECT_VERIFY_SSL": "false"
      }
    }
  }
}

Safety Features

This server provides layered safety controls for responsible operation:

Tool annotations — Every tool declares readOnlyHint and destructiveHint so MCP clients (like Claude Code) can make informed confirmation decisions
Read-only mode — Enabled by default. Only read operations (list, get, snapshot) are registered. Set UNIFI_PROTECT_READ_ONLY=false to enable write/mutating tools
Confirmation parameter — The most dangerous tools (protect_disable_mic, protect_trigger_alarm_webhook) require an explicit confirm: true parameter that must be present for the call to succeed
Dry-run support — All write tools (except those with confirm) accept an optional dryRun: true parameter that returns a preview of what would happen without making any changes

Tools (73 total)

System (2)

Tool	Description
`protect_get_info`	Get system information and version details
`protect_list_nvrs`	List all NVR devices

Subscriptions (2)

Tool	Description
`protect_subscribe_devices`	Subscribe via WebSocket to device state updates
`protect_subscribe_events`	Subscribe via WebSocket to event notifications

Cameras (12)

Tool	Description
`protect_list_cameras`	List all cameras
`protect_get_camera`	Get camera details by ID
`protect_update_camera`	Update camera settings
`protect_get_snapshot`	Get a JPEG snapshot (returns image)
`protect_create_rtsp_stream`	Create an RTSPS stream session
`protect_get_rtsp_streams`	Get active RTSPS stream sessions
`protect_delete_rtsp_stream`	Stop and delete an active RTSPS stream
`protect_create_talkback`	Create a talkback (two-way audio) session
`protect_disable_mic`	IRREVERSIBLE: Permanently disable camera microphone
`protect_start_ptz_patrol`	Start PTZ patrol at a given slot
`protect_stop_ptz_patrol`	Stop PTZ patrol
`protect_goto_ptz_preset`	Move PTZ to a preset position

Lights (3)

Tool	Description
`protect_list_lights`	List all lights
`protect_get_light`	Get light details by ID
`protect_update_light`	Update light settings

Sensors (3)

Tool	Description
`protect_list_sensors`	List all sensors
`protect_get_sensor`	Get sensor details by ID
`protect_update_sensor`	Update sensor settings

Chimes (3)

Tool	Description
`protect_list_chimes`	List all chimes
`protect_get_chime`	Get chime details by ID
`protect_update_chime`	Update chime settings

Viewers (3)

Tool	Description
`protect_list_viewers`	List all viewers
`protect_get_viewer`	Get viewer details by ID
`protect_update_viewer`	Update viewer settings

Sirens (6)

Tool	Description
`protect_list_sirens`	List all sirens
`protect_get_siren`	Get siren details by ID
`protect_update_siren`	Update siren settings (name, volume, LED)
`protect_play_siren`	Activate the siren alarm for a given duration (5/10/20/30s)
`protect_stop_siren`	Stop an active siren
`protect_test_siren_sound`	Test the siren sound for 5 seconds at a given volume

Fobs (3)

Tool	Description
`protect_list_fobs`	List all key fobs
`protect_get_fob`	Get fob details by ID
`protect_update_fob`	Update fob settings

Relays (4)

Tool	Description
`protect_list_relays`	List all relays
`protect_get_relay`	Get relay details by ID
`protect_update_relay`	Update relay settings
`protect_activate_relay_output`	Set/toggle a relay output channel, with optional pulse duration

Speakers (4)

Tool	Description
`protect_list_speakers`	List all speakers
`protect_get_speaker`	Get speaker details by ID
`protect_update_speaker`	Update speaker settings (volume, mic)
`protect_test_speaker_sound`	Test the speaker sound at a given volume

Bridges (3)

Tool	Description
`protect_list_bridges`	List all bridges
`protect_get_bridge`	Get bridge details by ID
`protect_update_bridge`	Update bridge settings

Link Stations (3)

Tool	Description
`protect_list_link_stations`	List all link stations (non-alarm-hub gateways)
`protect_get_link_station`	Get link station details by ID
`protect_update_link_station`	Update link station settings

Alarm Hubs (4)

Tool	Description
`protect_list_alarm_hubs`	List all alarm hubs
`protect_get_alarm_hub`	Get alarm hub details by ID
`protect_update_alarm_hub`	Update alarm hub settings
`protect_trigger_alarm_hub_output`	Trigger an alarm hub output channel (sirens, lights, etc.)

Arm Profiles (7) — local alarm manager

Tool	Description
`protect_list_arm_profiles`	List all arm profiles
`protect_create_arm_profile`	Create a new arm profile
`protect_set_current_arm_profile`	Set the active profile used when arming
`protect_update_arm_profile`	Update an arm profile
`protect_delete_arm_profile`	DESTRUCTIVE: Delete an arm profile by ID
`protect_enable_arm_alarm`	Arm the alarm using the current profile
`protect_disable_arm_alarm`	Disarm the alarm

Live Views (4)

Tool	Description
`protect_list_liveviews`	List all live views
`protect_get_liveview`	Get live view details by ID
`protect_create_liveview`	Create a new live view
`protect_update_liveview`	Update a live view

Alarm & Files (3)

Tool	Description
`protect_trigger_alarm_webhook`	Trigger an alarm webhook (fires external alarm action)
`protect_list_files`	List files by type
`protect_upload_file`	Upload a file (base64-encoded)

Users (4)

Tool	Description
`protect_list_users`	List Protect users (filtered by access permissions)
`protect_get_user`	Get a Protect user by ID
`protect_list_ulp_users`	List UniFi Identity (ULP) users with enrolled credentials
`protect_get_ulp_user`	Get a UniFi Identity user by ID

Development

npm run build        # Compile TypeScript
npm start            # Run the server
npm run typecheck    # Type-check without emitting
npm run lint         # ESLint
npm test             # Run all tests (vitest)

Commit conventions

This project uses conventional commits and release-please for automated releases:

feat: ... — new feature (minor version bump)
fix: ... — bug fix (patch version bump)
feat!: ... or BREAKING CHANGE: footer — breaking change (major version bump)
chore:, docs:, ci:, etc. — no version bump

On push to main, release-please opens a Release PR that bumps the version and updates CHANGELOG.md. Merging that PR publishes to npm automatically.

To override the version number, add Release-As: x.x.x in the commit body:

git commit --allow-empty -m "chore: release 2.0.0" -m "Release-As: 2.0.0"

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

6dRelease cycle

20Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/owine/unifi-protect-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server