How do I install the Uptime Kuma skill?

Run npx skillmds add modbender/uptime-kuma in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Uptime Kuma safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Uptime Kuma?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Uptime Kuma free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Uptime Kuma?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Uptime Kuma by modbender — Agent Skill

Name: Uptime Kuma
Rating: 4.5 (4 reviews)
Author: modbender

Uptime Kuma

Interact with Uptime Kuma monitoring server. Use for checking monitor status, adding/removing monitors, pausing/resuming checks, viewing heartbeat history. Triggers on mentions of Uptime Kuma, server monitoring, uptime checks, or service health monitoring.

modbender b72b73c 2 files · 11.4 KB Updated Sep 9, 2026 12 repo stars

File contents

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., http://localhost:3001)
UPTIME_KUMA_USERNAME - Login username
UPTIME_KUMA_PASSWORD - Login password

Usage

Script location: scripts/kuma.py

Commands

# Overall status summary
python scripts/kuma.py status

# List all monitors
python scripts/kuma.py list
python scripts/kuma.py list --json

# Get monitor details
python scripts/kuma.py get <id>

# Add monitors
python scripts/kuma.py add --name "My Site" --type http --url https://example.com
python scripts/kuma.py add --name "Server Ping" --type ping --hostname 192.168.1.1
python scripts/kuma.py add --name "SSH Port" --type port --hostname server.local --port 22

# Pause/resume monitors
python scripts/kuma.py pause <id>
python scripts/kuma.py resume <id>

# Delete monitor
python scripts/kuma.py delete <id>

# View heartbeat history
python scripts/kuma.py heartbeats <id> --hours 24

# List notification channels
python scripts/kuma.py notifications

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 https://api.example.com/health --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

---name: uptime-kumadescription: Interact with Uptime Kuma monitoring server. Use for checking monitor status, adding/removing monitors, pausing/resuming checks, viewing heartbeat history. Triggers on mentions of Uptime Kuma, server monitoring, uptime checks, or service health monitoring.--- # Uptime Kuma Skill Manage Uptime Kuma monitors via CLI wrapper around the Socket.IO API. ## Setup Requires `uptime-kuma-api` Python package: ```bash pip install uptime-kuma-api ``` Environment variables (set in shell or Clawdbot config): - `UPTIME_KUMA_URL` - Server URL (e.g., `http://localhost:3001`) - `UPTIME_KUMA_USERNAME` - Login username - `UPTIME_KUMA_PASSWORD` - Login password ## Usage Script location: `scripts/kuma.py` ### Commands ```bash # Overall status summary python scripts/kuma.py status # List all monitors python scripts/kuma.py list python scripts/kuma.py list --json # Get monitor details python scripts/kuma.py get <id> # Add monitors python scripts/kuma.py add --name "My Site" --type http --url https://example.com python scripts/kuma.py add --name "Server Ping" --type ping --hostname 192.168.1.1 python scripts/kuma.py add --name "SSH Port" --type port --hostname server.local --port 22 # Pause/resume monitors python scripts/kuma.py pause <id> python scripts/kuma.py resume <id> # Delete monitor python scripts/kuma.py delete <id> # View heartbeat history python scripts/kuma.py heartbeats <id> --hours 24 # List notification channels python scripts/kuma.py notifications ``` ### 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:** ```bash python scripts/kuma.py status python scripts/kuma.py list # Look for 🔴 ``` **Add HTTP monitor with 30s interval:** ```bash python scripts/kuma.py add --name "API Health" --type http --url https://api.example.com/health --interval 30 ``` **Maintenance mode (pause all):** ```bash for id in $(python scripts/kuma.py list --json | jq -r '.[].id'); do python scripts/kuma.py pause $id done ```

Frequently asked questions