How do I install the ntfy mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_TRANSPORT_TYPE`, `MCP_LOG_LEVEL`, `NTFY_DEFAULT_TOPIC`, `NTFY_BASE_URL`, `NTFY_AUTH_TOKEN`, `MCP_HTTP_HOST`, `MCP_HTTP_ENDPOINT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Ntfy MCP Server

Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP.

Remote serverstreamable-httpGo

What is the Ntfy MCP Server?

Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP.

What it actually does

Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
Typed error contracts via ctx.fail(reason, …) plus framework error factories (forbidden, notFound, validationError, …)
Pluggable auth: none, jwt, oauth
Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
Structured logging with optional OpenTelemetry tracing
STDIO and Streamable HTTP transports

Configuration

Bun v1.3.11 or higher (or Node.js v24+). - A topic name on an ntfy server. Public ntfy.sh requires no account; self-hosted instances and protected topics may need a bearer token or basic-auth credentials.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
ntfy_publish_message	Send or update a push notification on an ntfy topic.
ntfy_manage_message	Clear or delete a previously-sent notification by sequence_id.
ntfy_fetch_messages	Poll cached messages from one or more topics with optional filters.
ntfy_search_emoji_tags	Look up ntfy emoji tag short codes for use in tags.

How to install the Ntfy MCP Server

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": [
        "ntfy-mcp-server@latest"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Bun v1.3.11 or higher (or Node.js v24+). - A topic name on an ntfy server. Public ntfy.sh requires no account; self-hosted instances and protected topics may need a bearer token or basic-auth credentials.

Variable	Description	Required
MCP_TRANSPORT_TYPE	Declared in the maintainer’s client configuration.	Check documentation
MCP_LOG_LEVEL	Declared in the maintainer’s client configuration.	Check documentation
NTFY_DEFAULT_TOPIC	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Ntfy to ntfy publish message.”
“Use Ntfy to ntfy manage message.”
“Use Ntfy to ntfy fetch messages.”

Frequently asked questions

Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.