From unifi-access
Manages UniFi Access controllers via MCP tools: query doors/events/credentials/visitors/policies; lock/unlock doors and mutate with safety previews.
npx claudepluginhub sirkirby/unifi-mcp --plugin unifi-accessThis skill uses the workspace's default tool permissions.
You have access to a UniFi Access MCP server that lets you query and manage a UniFi Access controller. It provides 29 tools covering doors, locks, credentials, visitors, access policies, and events.
Manages UniFi network infrastructure including devices, clients, firewall, VPN, routing, WLANs, and statistics via 91 MCP server tools with lazy loading, safety gates, and confirmations.
Manages UniFi Protect cameras and NVR: views cameras, smart detections, recordings, snapshots, lights, sensors via 34 MCP tools with lazy loading and safety previews.
Configures UniFi Access MCP server by prompting for controller host, API key or username/password credentials, and permissions; saves to .claude/settings.local.json via Bash or PowerShell.
Share bugs, ideas, or general feedback.
You have access to a UniFi Access MCP server that lets you query and manage a UniFi Access controller. It provides 29 tools covering doors, locks, credentials, visitors, access policies, and events.
The server uses lazy loading by default — only meta-tools are registered initially:
| Meta-Tool | Purpose |
|---|---|
access_tool_index | List all 29 tools with full parameter schemas |
access_execute | Call any tool by name (essential in lazy mode) |
access_batch | Run multiple tools in parallel |
access_batch_status | Check async batch job status |
Workflow: Call access_tool_index to find the right tool, then access_execute to call it. Use access_batch for multiple independent queries.
All mutations are disabled by default because Access controls physical door locks and building entry.
Read operations — always available. Listing doors, events, users, credentials — all work without permissions.
Mutations require explicit opt-in via env vars:
UNIFI_POLICY_ACCESS_DOORS_UPDATE=true — lock/unlock doorsUNIFI_POLICY_ACCESS_CREDENTIALS_CREATE=true — create NFC/PIN/mobile credentialsUNIFI_POLICY_ACCESS_CREDENTIALS_DELETE=true — revoke credentialsUNIFI_POLICY_ACCESS_VISITORS_CREATE=true — create visitor passesUNIFI_POLICY_ACCESS_VISITORS_DELETE=true — delete visitor passesUNIFI_POLICY_ACCESS_POLICIES_UPDATE=true — update access policiesUNIFI_POLICY_ACCESS_DEVICES_UPDATE=true — reboot devicesConfirmation flow — every mutation uses preview-then-confirm:
confirm=true → executes the mutationDoor lock/unlock operations are physical real-world actions — always preview first.
All tools return: {"success": true, "data": ...}, {"success": false, "error": "..."}, or {"success": true, "requires_confirmation": true, "preview": ...}. Always check success first.
access_lock_door / access_unlock_door — unlock relocks automatically after duration (default 2 seconds)access_recent_events reads from websocket buffer instantly. Event types: door_open, door_close, access_granted, access_denied, door_alarmaccess_list_events with time/door/user filters. Topics: admin or admin_activityaccess_get_activity_summary aggregates events over a time period — useful for security audits{user_id, token}), PIN ({user_id, pin_code}), or mobile ({user_id}) credentialsAccess has two independent auth paths:
Either can work independently. For full functionality, configure both. If mutations fail with auth errors, the user needs username+password (API key alone is not enough for write operations).
To configure, run /unifi-access:setup or set env vars manually:
UNIFI_ACCESS_HOST=192.168.1.1
UNIFI_ACCESS_API_KEY=your-api-key
UNIFI_ACCESS_USERNAME=admin
UNIFI_ACCESS_PASSWORD=your-password
If the user also has networking or cameras, other UniFi MCP plugins are available:
unifi-network — network devices, clients, firewall, VPN, routingunifi-protect — security cameras, NVR, recordings, smart detectionsAccess readers are network clients — if a reader appears offline, the Network server can help check connectivity via unifi_lookup_by_ip.
For the complete list of all 29 tools organized by category with descriptions, tips, and common scenarios, read references/access-tools.md.