Uptime Kuma MCP Server
by davidfuchsio.github.DavidFuchs/mcp-uptime-kumav0.11.22
A Model Context Protocol (MCP) server for Uptime Kuma version 2.
context tax
queued
security
queued
cold start
queued
freshness
Active3d ago
Install Uptime Kuma MCP server
Install in Claude Code
claude mcp add uptime-kuma -e UPTIME_KUMA_URL='<uptime-kuma-url>' -e UPTIME_KUMA_PASSWORD='<uptime-kuma-password>' -e UPTIME_KUMA_2FA_TOKEN='<uptime-kuma-2fa-token>' -e UPTIME_KUMA_JWT_TOKEN='<uptime-kuma-jwt-token>' -e UPTIME_KUMA_HEADERS='<uptime-kuma-headers>' -- npx -y @davidfuchs/mcp-uptime-kumaInstall in Cursor
{
"mcpServers": {
"uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<uptime-kuma-url>",
"UPTIME_KUMA_PASSWORD": "<uptime-kuma-password>",
"UPTIME_KUMA_2FA_TOKEN": "<uptime-kuma-2fa-token>",
"UPTIME_KUMA_JWT_TOKEN": "<uptime-kuma-jwt-token>",
"UPTIME_KUMA_HEADERS": "<uptime-kuma-headers>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<uptime-kuma-url>",
"UPTIME_KUMA_PASSWORD": "<uptime-kuma-password>",
"UPTIME_KUMA_2FA_TOKEN": "<uptime-kuma-2fa-token>",
"UPTIME_KUMA_JWT_TOKEN": "<uptime-kuma-jwt-token>",
"UPTIME_KUMA_HEADERS": "<uptime-kuma-headers>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"uptime-kuma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<uptime-kuma-url>",
"UPTIME_KUMA_PASSWORD": "<uptime-kuma-password>",
"UPTIME_KUMA_2FA_TOKEN": "<uptime-kuma-2fa-token>",
"UPTIME_KUMA_JWT_TOKEN": "<uptime-kuma-jwt-token>",
"UPTIME_KUMA_HEADERS": "<uptime-kuma-headers>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<uptime-kuma-url>",
"UPTIME_KUMA_PASSWORD": "<uptime-kuma-password>",
"UPTIME_KUMA_2FA_TOKEN": "<uptime-kuma-2fa-token>",
"UPTIME_KUMA_JWT_TOKEN": "<uptime-kuma-jwt-token>",
"UPTIME_KUMA_HEADERS": "<uptime-kuma-headers>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| UPTIME_KUMA_URL | yes | — | The URL of your Uptime Kuma instance |
| UPTIME_KUMA_USERNAME | — | — | Your Uptime Kuma username (not required if using JWT token authentication or if authentication is disabled) |
| UPTIME_KUMA_PASSWORD | — | yes | Your Uptime Kuma password (not required if using JWT token authentication or if authentication is disabled) |
| UPTIME_KUMA_2FA_TOKEN | — | yes | Your 2FA token (only required if two-factor authentication is enabled on your account) |
| UPTIME_KUMA_JWT_TOKEN | — | yes | Your JWT token for authentication (takes precedence over username/password if provided) |
| UPTIME_KUMA_HEADERS | — | yes | JSON object of extra HTTP headers sent on every request to Uptime Kuma, for reaching it through an authenticating proxy such as Cloudflare Access (e.g. {"CF-Access-Client-Id":"...","CF-Access-Client-Secret":"..."}) |
Freshness
Active — last maintenance signal 3d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-06 · 3d ago · GitHub
Latest release
2026-10-06 · 3d ago · GitHub · v0.11.22
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v0.11.22
FAQ
›How do I install the Uptime Kuma MCP server in Claude Code?
Run: claude mcp add uptime-kuma -e UPTIME_KUMA_URL='<uptime-kuma-url>' -e UPTIME_KUMA_PASSWORD='<uptime-kuma-password>' -e UPTIME_KUMA_2FA_TOKEN='<uptime-kuma-2fa-token>' -e UPTIME_KUMA_JWT_TOKEN='<uptime-kuma-jwt-token>' -e UPTIME_KUMA_HEADERS='<uptime-kuma-headers>' -- npx -y @davidfuchs/mcp-uptime-kuma. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Uptime Kuma require an API key?
Yes. It expects UPTIME_KUMA_URL, UPTIME_KUMA_PASSWORD, UPTIME_KUMA_2FA_TOKEN, UPTIME_KUMA_JWT_TOKEN, UPTIME_KUMA_HEADERS, of which 4 are secrets.
›Can I use Uptime Kuma as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Uptime Kuma in the official MCP registry?
Yes, as io.github.DavidFuchs/mcp-uptime-kuma.