ntfy-mcp-server

Package (npm 2.3.5)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "NTFY_SERVERS": "<YOUR_VALUE>",
        "NTFY_BASE_URL": "<YOUR_VALUE>",
        "NTFY_DEFAULT_TOPIC": "<YOUR_VALUE>",
        "NTFY_AUTH_TOKEN": "<YOUR_VALUE>",
        "NTFY_AUTH_USERNAME": "<YOUR_VALUE>",
        "NTFY_AUTH_PASSWORD": "<YOUR_VALUE>",
        "NTFY_REQUEST_TIMEOUT_MS": "<YOUR_VALUE>",
        "NTFY_MAX_RETRIES": "<YOUR_VALUE>",
        "NTFY_BLOCK_PRIVATE_HOSTS": "<YOUR_VALUE>",
        "MCP_LOG_LEVEL": "<YOUR_VALUE>",
        "LOGS_DIR": "<YOUR_VALUE>",
        "OTEL_ENABLED": "<YOUR_VALUE>"
      }
    }
  }
}

• NTFY_SERVERS — JSON 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_URL — Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.
• NTFY_DEFAULT_TOPIC — Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.
• NTFY_AUTH_TOKEN — Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.
• NTFY_AUTH_USERNAME — Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.
• NTFY_AUTH_PASSWORD — Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.
• NTFY_REQUEST_TIMEOUT_MS — Per-request HTTP timeout in milliseconds.
• NTFY_MAX_RETRIES — Max retry attempts for transient upstream failures (5xx, network, 429).
• NTFY_BLOCK_PRIVATE_HOSTS — When 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.
• MCP_LOG_LEVEL — Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
• LOGS_DIR — Directory for file-based logs (Node only; ignored on Workers).
• OTEL_ENABLED — Enable OpenTelemetry instrumentation (spans, metrics, completion logs).

This server takes extra arguments — see its repository.

Package (npm 2.3.5)

Package: npm ntfy-mcp-server

• NTFY_SERVERS — JSON 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_URL — Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.
• NTFY_DEFAULT_TOPIC — Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.
• NTFY_AUTH_TOKEN — Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.
• NTFY_AUTH_USERNAME — Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.
• NTFY_AUTH_PASSWORD — Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.
• NTFY_REQUEST_TIMEOUT_MS — Per-request HTTP timeout in milliseconds.
• NTFY_MAX_RETRIES — Max retry attempts for transient upstream failures (5xx, network, 429).
• NTFY_BLOCK_PRIVATE_HOSTS — When 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.
• MCP_SESSION_MODE — HTTP 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_HOST — The hostname for the HTTP server.
• MCP_HTTP_PORT — The port to run the HTTP server on.
• MCP_HTTP_ENDPOINT_PATH — The endpoint path for the MCP server.
• MCP_AUTH_MODE — Authentication mode to use: 'none', 'jwt', or 'oauth'.
• MCP_LOG_LEVEL — Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
• LOGS_DIR — Directory for file-based logs (Node only; ignored on Workers).
• OTEL_ENABLED — Enable OpenTelemetry instrumentation (spans, metrics, completion logs).

This server takes extra arguments — see its repository.