MCP server
Ntfy MCP Server
Send, manage, and replay ntfy push notifications via MCP.
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 2.4.1
- Listing updated
- 5 days ago
About Ntfy MCP Server
Ntfy MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add ntfy-mcp-server -- npx -y ntfy-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"ntfy-mcp-server": {
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ntfy-mcp-server": {
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"ntfy-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ntfy-mcp-server": {
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ntfy-mcp-server": {
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
NTFY_SERVERSJSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand.NTFY_BASE_URLSingle-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.NTFY_DEFAULT_TOPICTopic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.NTFY_AUTH_TOKENBearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.NTFY_AUTH_USERNAMEBasic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.NTFY_AUTH_PASSWORDBasic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.NTFY_REQUEST_TIMEOUT_MSPer-attempt HTTP timeout in milliseconds, covering the response body. Each call is also capped at 50 s across all attempts.NTFY_MAX_RETRIESMax retry attempts for transient upstream failures (5xx, network, 429).NTFY_BLOCK_PRIVATE_HOSTSWhen true, a per-call `base_url` override must resolve to a public address and its redirects are not followed. Servers registered under NTFY_SERVERS / NTFY_BASE_URL are exempt. Turn it on where callers you do not control can reach the server.NTFY_CLAMP_LIMITSWhen true, a `limit` above a tool's per-call cap (100 for ntfy_fetch_messages, 200 for ntfy_search_emoji_tags) is served as the cap with a notice, and the input schema advertises no maximum. Set to false to advertise and enforce a schema maximum at the cap instead, so a larger value is rejected.NTFY_ENABLE_EMOJI_TAGSSet to false to disable the ntfy_search_emoji_tags tool: it leaves tools/list, and the server instructions and ntfy_publish_message stop pointing at it.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').LOGS_DIRDirectory for file-based logs (Node only; ignored on Workers).OTEL_ENABLEDEnable OpenTelemetry instrumentation (spans, metrics, completion logs).MCP_TRANSPORT_TYPESelects the HTTP transport.NTFY_SERVERSJSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand.NTFY_BASE_URLSingle-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.NTFY_DEFAULT_TOPICTopic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.NTFY_AUTH_TOKENBearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.NTFY_AUTH_USERNAMEBasic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.NTFY_AUTH_PASSWORDBasic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.NTFY_REQUEST_TIMEOUT_MSPer-attempt HTTP timeout in milliseconds, covering the response body. Each call is also capped at 50 s across all attempts.NTFY_MAX_RETRIESMax retry attempts for transient upstream failures (5xx, network, 429).NTFY_BLOCK_PRIVATE_HOSTSWhen true, a per-call `base_url` override must resolve to a public address and its redirects are not followed. Servers registered under NTFY_SERVERS / NTFY_BASE_URL are exempt. Turn it on where callers you do not control can reach the server.NTFY_CLAMP_LIMITSWhen true, a `limit` above a tool's per-call cap (100 for ntfy_fetch_messages, 200 for ntfy_search_emoji_tags) is served as the cap with a notice, and the input schema advertises no maximum. Set to false to advertise and enforce a schema maximum at the cap instead, so a larger value is rejected.NTFY_ENABLE_EMOJI_TAGSSet to false to disable the ntfy_search_emoji_tags tool: it leaves tools/list, and the server instructions and ntfy_publish_message stop pointing at it.MCP_SESSION_MODEHTTP session model: 'auto', 'stateful', or 'stateless'. This server requires 'stateful' over HTTP — the consent prompt on destructive and outbound calls is a multi-round-trip request that a 2025-era HTTP client can only complete over a live session — so an HTTP start with 'stateless' is refused. 'auto' resolves to 'stateful'; stdio ignores the setting.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_REQUEST_STATE_KEYRecommended for HTTP. Key (>= 32 bytes, the same on every instance) that seals the requestState carrying the consent-record id of a confirmation prompt, bound to the caller for 900 s; a forged, tampered, or expired state is rejected before the handler runs.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').LOGS_DIRDirectory for file-based logs (Node only; ignored on Workers).OTEL_ENABLEDEnable OpenTelemetry instrumentation (spans, metrics, completion logs).
Pricing
Open source
Ntfy MCP Server FAQ
Is Ntfy MCP Server free?
Yes. Ntfy MCP Server is open source, so you can use and self-host it for free.
How do I add Ntfy MCP Server to Claude Code?
Run this command in your terminal: claude mcp add ntfy-mcp-server -- npx -y ntfy-mcp-server
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.