Publish ntfy notifications, read the message cache, and manage users and topic access
Connect Runs on your machine
claude mcp add ntfy-mcp -e NTFY_URL=<NTFY_URL> -e NTFY_TOKEN=<NTFY_TOKEN> -e NTFY_USERNAME=<NTFY_USERNAME> -e NTFY_PASSWORD=<NTFY_PASSWORD> -e NTFY_TOPICS=<NTFY_TOPICS> -e NTFY_READ_ONLY=<NTFY_READ_ONLY> -e NTFY_INSECURE_TLS=<NTFY_INSECURE_TLS> -e NTFY_ALLOW_TOOLS=<NTFY_ALLOW_TOOLS> -e NTFY_DENY_TOOLS=<NTFY_DENY_TOOLS> -- npx -y @ni-c/[email protected]{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_USERNAME": "<NTFY_USERNAME>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>",
"NTFY_TOPICS": "<NTFY_TOPICS>",
"NTFY_READ_ONLY": "<NTFY_READ_ONLY>",
"NTFY_INSECURE_TLS": "<NTFY_INSECURE_TLS>",
"NTFY_ALLOW_TOOLS": "<NTFY_ALLOW_TOOLS>",
"NTFY_DENY_TOOLS": "<NTFY_DENY_TOOLS>"
}
}
}
}{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_USERNAME": "<NTFY_USERNAME>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>",
"NTFY_TOPICS": "<NTFY_TOPICS>",
"NTFY_READ_ONLY": "<NTFY_READ_ONLY>",
"NTFY_INSECURE_TLS": "<NTFY_INSECURE_TLS>",
"NTFY_ALLOW_TOOLS": "<NTFY_ALLOW_TOOLS>",
"NTFY_DENY_TOOLS": "<NTFY_DENY_TOOLS>"
}
}
}
}{
"servers": {
"ntfy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ni-c/[email protected]"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_USERNAME": "<NTFY_USERNAME>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>",
"NTFY_TOPICS": "<NTFY_TOPICS>",
"NTFY_READ_ONLY": "<NTFY_READ_ONLY>",
"NTFY_INSECURE_TLS": "<NTFY_INSECURE_TLS>",
"NTFY_ALLOW_TOOLS": "<NTFY_ALLOW_TOOLS>",
"NTFY_DENY_TOOLS": "<NTFY_DENY_TOOLS>"
}
}
}
}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 |
|---|---|
NTFY_URLRequired | Base URL of the ntfy server, e.g. https://ntfy.example.net. There is deliberately no default. |
NTFY_TOKENOptional, secret | ntfy access token (tk_...). Optional: an open instance needs no credentials. Mutually exclusive with NTFY_USERNAME/NTFY_PASSWORD. |
NTFY_USERNAMEOptional | Username for basic authentication. Must be set together with NTFY_PASSWORD. |
NTFY_PASSWORDOptional, secret | Password for basic authentication. Must be set together with NTFY_USERNAME. |
NTFY_TOPICSOptional | Comma-separated topics the server may use. The first is the default when a tool omits one, and the list restricts every read and write tool. |
NTFY_READ_ONLYOptional | Set to exactly true to register only the six read tools (default: false — ntfy exists to publish) |
NTFY_INSECURE_TLSOptional | Set to true to accept a self-signed certificate from the ntfy server (default: false) |
NTFY_ALLOW_TOOLSOptional | Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools) |
NTFY_DENY_TOOLSOptional | Comma-separated tool names or list_* prefixes to remove from whatever the allow list left |
Details
| Package | @ni-c/[email protected] (NPM, stdio) |
| Package | ghcr.io/ni-c/ntfy-mcp:0.3.0 (OCI, stdio) |
| First published | 7 Sep 2026 |
| Last updated | 7 Sep 2026 |
| Registry name | io.github.ni-c/ntfy-mcp |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.