Uptime Kuma Skill

Manage Uptime Kuma monitors via CLI wrapper around the Socket.IO API.

Setup

Requires uptime-kuma-api Python package:

pip install uptime-kuma-api

Environment variables (set in shell or Clawdbot config):

• UPTIME_KUMA_URL - Server URL (e.g., ) - UPTIME_KUMA_USERNAME - Login username - UPTIME_KUMA_PASSWORD - Login password ## Usage Script location: scripts/kuma.py ### Commands __CODE_BLOCK_1__ ### Monitor Types - http - HTTP/HTTPS endpoint - ping - ICMP ping - port - TCP port check - keyword - HTTP + keyword search - dns - DNS resolution - docker - Docker container - push - Push-based (passive) - mysql, postgres, mongodb, redis - Database checks - mqtt - MQTT broker - group` - Monitor group

Common Workflows

Check what's down:

python scripts/kuma.py status
python scripts/kuma.py list  # Look for 🔴

Add HTTP monitor with 30s interval:

python scripts/kuma.py add --name "API Health" --type http --url  --interval 30

Maintenance mode (pause all):

for id in $(python scripts/kuma.py list --json | jq -r '.[].id'); do
  python scripts/kuma.py pause $id
done