unifi
by jmagar
Self-Hosted & AutomationBrief
Query and monitor UniFi network via local gateway API.
Description
What This Skill Does
Queries and monitors a local UniFi network through the UniFi OS gateway API. Supports read-only access to devices, active clients, network health, DPI traffic data, and recent alerts. Tested on Cloud Gateway Max.
Pulls live data directly from the local UniFi OS API without requiring Ubiquiti cloud access or the web UI.
When to Use It
- Checking which devices are currently connected to the network
- Identifying which apps are consuming the most bandwidth
- Reviewing recent network alerts and alarms
- Getting a full network health summary in one command
- Listing all APs, switches, and gateway status
Example Workflow
User asks: What's using the most bandwidth on my network?
- 1
Read credentials from ~/.clawdbot/credentials/unifi/config.json
- 2
Authenticate against the local UniFi OS gateway
- 3
Run scripts/top-apps.sh to query DPI traffic data
- 4
Parse and format application bandwidth usage
- 5
Present ranked list of top applications with RX/TX totals
Table showing top 10 applications by total traffic, with category, RX, TX, and combined bandwidth in GB
Requirements
- UniFi OS gateway (e.g. Cloud Gateway Max) accessible on local network
- Local UniFi OS admin username and password
- Credentials file at ~/.clawdbot/credentials/unifi/config.json
Installation
clawhub install jmagar/unifiRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.