io.github.cyanheads/ntfy-mcp-server

io.github.cyanheads/ntfy-mcp-server·v2.0.1·Developer Tools

Quality Score

/100

Send, manage, and replay ntfy push notifications via MCP.

Repository →

§00 Trust verdict · v1 advisory · method

UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-mcp-server"
      ],
      "env": {
        "NTFY_SERVERS": "<ntfy_servers>",
        "NTFY_BASE_URL": "https://ntfy.sh",
        "NTFY_DEFAULT_TOPIC": "<ntfy_default_topic>",
        "NTFY_AUTH_TOKEN": "<ntfy_auth_token>",
        "NTFY_AUTH_USERNAME": "<ntfy_auth_username>",
        "NTFY_AUTH_PASSWORD": "<ntfy_auth_password>",
        "NTFY_REQUEST_TIMEOUT_MS": "15000",
        "NTFY_MAX_RETRIES": "3",
        "MCP_LOG_LEVEL": "info",
        "LOGS_DIR": "./logs",
        "OTEL_ENABLED": "false",
        "MCP_SESSION_MODE": "auto",
        "MCP_HTTP_HOST": "127.0.0.1",
        "MCP_HTTP_PORT": "3010",
        "MCP_HTTP_ENDPOINT_PATH": "/mcp",
        "MCP_AUTH_MODE": "none"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-mcp-server"
      ],
      "env": {
        "NTFY_SERVERS": "<ntfy_servers>",
        "NTFY_BASE_URL": "https://ntfy.sh",
        "NTFY_DEFAULT_TOPIC": "<ntfy_default_topic>",
        "NTFY_AUTH_TOKEN": "<ntfy_auth_token>",
        "NTFY_AUTH_USERNAME": "<ntfy_auth_username>",
        "NTFY_AUTH_PASSWORD": "<ntfy_auth_password>",
        "NTFY_REQUEST_TIMEOUT_MS": "15000",
        "NTFY_MAX_RETRIES": "3",
        "MCP_LOG_LEVEL": "info",
        "LOGS_DIR": "./logs",
        "OTEL_ENABLED": "false",
        "MCP_SESSION_MODE": "auto",
        "MCP_HTTP_HOST": "127.0.0.1",
        "MCP_HTTP_PORT": "3010",
        "MCP_HTTP_ENDPOINT_PATH": "/mcp",
        "MCP_AUTH_MODE": "none"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y ntfy-mcp-server

§02 Environment variables

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).

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).

NTFY_SERVERS

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).

MCP_SESSION_MODE

HTTP session model: 'stateless', 'stateful', or 'auto'.

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).

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Developer Tools

RedditGrow

ai.redditgrow/mcp

Reddit growth toolkit — opportunities, replies, cold DMs, brand mentions, SEO, autopilot.

ai.smithery/DynamicEndpoints-powershell-exec-mcp-server

Execute PowerShell commands securely with controlled timeouts and input validation. Retrieve syste…

ai.smithery/neverinfamous-memory-journal-mcp

A MCP server built for developers enabling Git based project management with project and personal…