ntfy mcp server for Gemini CLI

io.github.cyanheads/ntfy-mcp-server

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

client:Gemini CLI transport:stdio runtime:npm

Install ntfy mcp server in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

NTFY_SERVERS

NTFY_BASE_URL

NTFY_DEFAULT_TOPIC

NTFY_AUTH_TOKEN

NTFY_AUTH_USERNAME

NTFY_AUTH_PASSWORD

NTFY_REQUEST_TIMEOUT_MS

NTFY_MAX_RETRIES

NTFY_BLOCK_PRIVATE_HOSTS

MCP_LOG_LEVEL

LOGS_DIR

OTEL_ENABLED

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-mcp-server"
      ],
      "env": {
        "NTFY_SERVERS": "<NTFY_SERVERS>",
        "NTFY_BASE_URL": "<NTFY_BASE_URL>",
        "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": "<NTFY_REQUEST_TIMEOUT_MS>",
        "NTFY_MAX_RETRIES": "<NTFY_MAX_RETRIES>",
        "NTFY_BLOCK_PRIVATE_HOSTS": "<NTFY_BLOCK_PRIVATE_HOSTS>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "LOGS_DIR": "<LOGS_DIR>",
        "OTEL_ENABLED": "<OTEL_ENABLED>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

ntfy mcp server in other clients

ntfy mcp server MCP server