Uptime Kuma MCP Server
A Model Context Protocol (MCP) server for Uptime Kuma version 2. Supports stdio and streamable HTTP transports. Its 28 documented tools cluster into read & search, create & write, delete, update.
People who work with Uptime and Allowed and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-09-13 · ★ 49 · #8 OF 120 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-09-18
MIT · TypeScript servers · how we verify → /methodology
01 · Install Uptime Kuma
before you install - you'll need
Set UPTIME_KUMA_URL, UPTIME_KUMA_USERNAME, UPTIME_KUMA_PASSWORD, UPTIME_KUMA_JWT_TOKEN, UPTIME_KUMA_HEADERS, ALLOWED_ORIGIN, TRUST_PROXY, UPTIME_KUMA_INCLUDE_SECRETS, MCP_AUTH_TOKEN before connecting. UPTIME_KUMA_2FA_TOKEN is optional or environment-specific per the README.
Claude Code
claude mcp add davidfuchs-mcp-uptime-kuma -- npx -y @davidfuchs/mcp-uptime-kumaClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"davidfuchs-mcp-uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
npm package @davidfuchs/mcp-uptime-kuma - published under the repo owner's npm scope (@davidfuchs)
registry namespace io.github.DavidFuchs is GitHub-verified and matches the repo owner
03 · What Uptime Kuma can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can get a quick overview of all monitors with their current status. Supports filtering, get all available monitor types supported by Uptime Kuma, get detailed configuration for a specific monitor by ID, and create a new monitor (requires name and type at minimum).
Capability map
Tools grouped from the project's README - what Uptime Kuma lets an agent do.
read & search
11 tools - e.g. Get a quick overview of all monitors with their current status. Supports filtering.; Get the full list of all monitors with configurations. Supports filtering.; Get all available monitor types supported…
getMonitorSummary · listMonitors · listMonitorTypes · getMonitor · listHeartbeats · getHeartbeats…
create & write
4 tools - e.g. Create a new monitor (requires name and type at minimum).; Create a new notification channel.; Create a new tag that can be assigned to monitors.
createMonitor · addNotification · addTag · createMaintenance
delete
3 tools - e.g. Permanently delete a monitor and all its heartbeat history.; Permanently delete a notification channel.; Permanently delete a tag (removes it from all monitors).
deleteMonitor · deleteNotification · deleteTag
update
2 tools - e.g. Update an existing monitor's configuration.; Update an existing notification channel.
updateMonitor · updateNotification
Pause Monitor
1 tool - e.g. Pause a monitor to stop performing checks.
pauseMonitor
Resume Monitor
1 tool - e.g. Resume a paused monitor to restart checks.
resumeMonitor
Keywords
1 tool - e.g. Space-separated keywords for fuzzy matching against monitor pathNames
keywords
Type
1 tool - e.g. Monitor type(s), comma-separated (e.g., "http", "http,ping,dns")
type
Latest releases
v0.11.18 · 2026-09-11
bump hono from 4.13.0 to 4.13.7 in the npm_and_yarn group across 1 directory · bump @vitest/mocker from 4.1.9 to 5.0.0 in the npm_and_yarn group across 0 directory · support custom HTTP headers via UPTIME_KUMA_HEADERS…
v0.11.15 · 2026-09-08
bump fast-uri from 3.1.5 to 3.1.7 in the npm_and_yarn group across 1 directory · bump qs from 6.15.3 to 6.16.0 in the npm_and_yarn group across 1 directory · normalize Kuma response message values · support TRUST_PROXY…
v0.11.9 · 2026-08-16
finish #65 - stop coercing junk into numeric arguments, and filter summaries by parent
04 · Who maintains Uptime Kuma
mcp-uptime-kuma is maintained by davidfuchs. It's the only MCP server we track from this author; the repo dates to Nov 2025.
05 · Facts
- repository
- github.com/davidfuchs/mcp-uptime-kuma
- category
- DevOps & monitoring - ranked #8 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
- release cadence
- 8 releases in the last 90 days (latest 2026-09-11)
- registry
- io.github.DavidFuchs/mcp-uptime-kuma (active, first published 2025-11-25 · 15 versions)
- packages
- npm:@davidfuchs/mcp-uptime-kuma
06 · Uptime Kuma FAQ
Is Uptime Kuma still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-13 and it shipped 8 releases in the last 90 days. We re-verify nightly.
What can Uptime Kuma do?
With this server connected, an agent can get a quick overview of all monitors with their current status. Supports filtering, get all available monitor types supported by Uptime Kuma, get detailed configuration for a specific monitor by ID, and create a new monitor (requires name and type at minimum).
How do I install Uptime Kuma?
Run `npx -y @davidfuchs/mcp-uptime-kuma`. The README documents 10 environment variables (UPTIME_KUMA_URL, UPTIME_KUMA_USERNAME, UPTIME_KUMA_PASSWORD…) to set first. Set UPTIME_KUMA_URL, UPTIME_KUMA_USERNAME, UPTIME_KUMA_PASSWORD, UPTIME_KUMA_JWT_TOKEN, UPTIME_KUMA_HEADERS, ALLOWED_ORIGIN, TRUST_PROXY, UPTIME_KUMA_INCLUDE_SECRETS, MCP_AUTH_TOKEN before connecting. UPTIME_KUMA_2FA_TOKEN is optional or environment-specific per the README. You can also paste the ready-made client config above.
Does Uptime Kuma run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Uptime Kuma
Alternatives to Uptime Kuma
Maintained DevOps & monitoring servers if Uptime Kuma isn't the fit.
- World Monitor Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 75 tools. ★ 86,725 · 2026-09-17
- Open Metadata Official OpenMetadata MCP: 21 read and write tools for search, lineage, data quality, governance. ★ 15,244 · 2026-09-18
- Kubeshark MCP Server Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS. ★ 12,082 · 2026-09-09
- Grafana An MCP server giving access to Grafana dashboards, data and more. ★ 3,467 · 2026-09-17
- Radar Kubernetes MCP Server Kubernetes MCP server for diagnosis, resource management, GitOps, and RBAC-enforced operations. ★ 3,371 · 2026-09-18
- Testkube MCP MCP server for Testkube - Manage test workflows, executions, and artifacts via AI assistants ★ 1,658 · 2026-09-18
Pairs well with
Servers that cover what Uptime Kuma doesn't - only shown when the pairing reason fits the companion.
More DevOps & monitoring MCP servers · GCP Platform Engineer · Process · Dynatrace · Dynatrace Managed MCP · Taskbounty Check
More TypeScript MCP servers · Apple Health MCP · Eight Sleep MCP · Fitbitmcp · Garminmcp · Google Ads MCP · see all