Skip to content
MCP server

ntfy

Publish ntfy notifications, read the message cache, and manage users and topic access

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.0
Listing updated
5 days ago

About ntfy

ntfy is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add ntfy-mcp --env NTFY_URL='<NTFY_URL>' --env NTFY_TOKEN='<NTFY_TOKEN>' --env NTFY_PASSWORD='<NTFY_PASSWORD>' -- npx -y @ni-c/ntfy-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ntfy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/ntfy-mcp"
      ],
      "env": {
        "NTFY_URL": "<NTFY_URL>",
        "NTFY_TOKEN": "<NTFY_TOKEN>",
        "NTFY_PASSWORD": "<NTFY_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ntfy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/ntfy-mcp"
      ],
      "env": {
        "NTFY_URL": "<NTFY_URL>",
        "NTFY_TOKEN": "<NTFY_TOKEN>",
        "NTFY_PASSWORD": "<NTFY_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ntfy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/ntfy-mcp"
      ],
      "env": {
        "NTFY_URL": "<NTFY_URL>",
        "NTFY_TOKEN": "<NTFY_TOKEN>",
        "NTFY_PASSWORD": "<NTFY_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ntfy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/ntfy-mcp"
      ],
      "env": {
        "NTFY_URL": "<NTFY_URL>",
        "NTFY_TOKEN": "<NTFY_TOKEN>",
        "NTFY_PASSWORD": "<NTFY_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ntfy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/ntfy-mcp"
      ],
      "env": {
        "NTFY_URL": "<NTFY_URL>",
        "NTFY_TOKEN": "<NTFY_TOKEN>",
        "NTFY_PASSWORD": "<NTFY_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NTFY_URLBase URL of the ntfy server, e.g. https://ntfy.example.net. There is deliberately no default.Required
  • NTFY_TOKENntfy access token (tk_...). Optional: an open instance needs no credentials. Mutually exclusive with NTFY_USERNAME/NTFY_PASSWORD.
  • NTFY_USERNAMEUsername for basic authentication. Must be set together with NTFY_PASSWORD.
  • NTFY_PASSWORDPassword for basic authentication. Must be set together with NTFY_USERNAME.
  • NTFY_TOPICSComma-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_ONLYSet to exactly true to register only the six read tools (default: false — ntfy exists to publish)
  • NTFY_INSECURE_TLSSet to true to accept a self-signed certificate from the ntfy server (default: false)
  • NTFY_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • NTFY_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever the allow list left
  • NTFY_URLBase URL of the ntfy server, e.g. https://ntfy.example.net. There is deliberately no default.Required
  • NTFY_TOKENntfy access token (tk_...). Optional: an open instance needs no credentials. Mutually exclusive with NTFY_USERNAME/NTFY_PASSWORD.
  • NTFY_USERNAMEUsername for basic authentication. Must be set together with NTFY_PASSWORD.
  • NTFY_PASSWORDPassword for basic authentication. Must be set together with NTFY_USERNAME.
  • NTFY_TOPICSComma-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_ONLYSet to exactly true to register only the six read tools (default: false — ntfy exists to publish)
  • NTFY_INSECURE_TLSSet to true to accept a self-signed certificate from the ntfy server (default: false)
  • NTFY_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • NTFY_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever the allow list left

Pricing

Open source

Prices change. Check ntfy-mcp.ni-c.de before you buy.

ntfy FAQ

Is ntfy free?

Yes. ntfy is open source, so you can use and self-host it for free.

How do I add ntfy to Claude Code?

Run this command in your terminal: claude mcp add ntfy-mcp --env NTFY_URL='<NTFY_URL>' --env NTFY_TOKEN='<NTFY_TOKEN>' --env NTFY_PASSWORD='<NTFY_PASSWORD>' -- npx -y @ni-c/ntfy-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers