Manage your Uptime Kuma 2 instance from an LLM: monitors, status pages, notifications, maintenance
Connect Runs on your machine
claude mcp add mcp-uptime-kuma -e UPTIME_KUMA_URL=<UPTIME_KUMA_URL> -e UPTIME_KUMA_USERNAME=<UPTIME_KUMA_USERNAME> -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> -e UPTIME_KUMA_INCLUDE_SECRETS=<UPTIME_KUMA_INCLUDE_SECRETS> -e UPTIME_KUMA_READ_ONLY=<UPTIME_KUMA_READ_ONLY> -- npx -y @davidfuchs/[email protected]{
"mcpServers": {
"mcp-uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/[email protected]"
],
"env": {
"UPTIME_KUMA_URL": "<UPTIME_KUMA_URL>",
"UPTIME_KUMA_USERNAME": "<UPTIME_KUMA_USERNAME>",
"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>",
"UPTIME_KUMA_INCLUDE_SECRETS": "<UPTIME_KUMA_INCLUDE_SECRETS>",
"UPTIME_KUMA_READ_ONLY": "<UPTIME_KUMA_READ_ONLY>"
}
}
}
}{
"mcpServers": {
"mcp-uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/[email protected]"
],
"env": {
"UPTIME_KUMA_URL": "<UPTIME_KUMA_URL>",
"UPTIME_KUMA_USERNAME": "<UPTIME_KUMA_USERNAME>",
"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>",
"UPTIME_KUMA_INCLUDE_SECRETS": "<UPTIME_KUMA_INCLUDE_SECRETS>",
"UPTIME_KUMA_READ_ONLY": "<UPTIME_KUMA_READ_ONLY>"
}
}
}
}{
"servers": {
"mcp-uptime-kuma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@davidfuchs/[email protected]"
],
"env": {
"UPTIME_KUMA_URL": "<UPTIME_KUMA_URL>",
"UPTIME_KUMA_USERNAME": "<UPTIME_KUMA_USERNAME>",
"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>",
"UPTIME_KUMA_INCLUDE_SECRETS": "<UPTIME_KUMA_INCLUDE_SECRETS>",
"UPTIME_KUMA_READ_ONLY": "<UPTIME_KUMA_READ_ONLY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
UPTIME_KUMA_URLRequired | The URL of your Uptime Kuma instance |
UPTIME_KUMA_USERNAMEOptional | Your Uptime Kuma username (not required if using JWT token authentication or if authentication is disabled) |
UPTIME_KUMA_PASSWORDOptional, secret | Your Uptime Kuma password (not required if using JWT token authentication or if authentication is disabled) |
UPTIME_KUMA_2FA_TOKENOptional, secret | Your 2FA token (only required if two-factor authentication is enabled on your account) |
UPTIME_KUMA_JWT_TOKENOptional, secret | Your JWT token for authentication (takes precedence over username/password if provided) |
UPTIME_KUMA_HEADERSOptional, secret | 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":"..."}) |
UPTIME_KUMA_INCLUDE_SECRETSOptional | Set to true to return credentials (passwords, tokens, auth headers) unredacted in tool output; by default they read "***" |
UPTIME_KUMA_READ_ONLYOptional | Set to true to expose only the tools that report, and none that create, change, pause or delete |
Details
| Package | @davidfuchs/[email protected] (NPM, stdio) |
| Package | @davidfuchs/[email protected] (NPM, streamable-http) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.DavidFuchs/mcp-uptime-kuma |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.