Ntfy MCP Server

Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP. Its 4 documented tools cover ntfy, message.

People who work with ntfy and message and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-16 · ★ 22 · #51 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Ntfy MCP Server

before you install - you'll need

Set MCP_LOG_LEVEL, NTFY_DEFAULT_TOPIC before connecting. MCP_TRANSPORT_TYPE is optional or environment-specific per the README.

Claude Code

claude mcp add cyanheads-ntfy-mcp-server -- npx -y ntfy-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package ntfy-mcp-server - unscoped; check the name against the project README before installing

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Ntfy MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 4 documented tools spanning ntfy, message, including ntfy_publish_message, ntfy_manage_message, ntfy_fetch_messages, ntfy_search_emoji_tags.

The 4 tools it gives your agent

Extracted from the project's README - what ntfy-mcp-server lets an agent do.

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.

Latest releases

v2.3.4 · 2026-09-16

mcp-ts-core 0.13.2, required stateful HTTP sessions · HTTP now refuses to start under MCP_SESSION_MODE=stateless - the consent gate on ntfy_manage_message and outbound-action publishes needs a live session to complete…

v2.3.3 · 2026-09-04

upstream-failure detection and cancellation fix · isUpstreamUnreachable recognizes retry-exhausted 5xx failures again under mcp-ts-core 0.12.4's ServiceUnavailable/Timeout classification · a cancelled ntfy request now…

v2.3.2 · 2026-08-22

Docker multi-arch build fix · Container image publishes again - the build stage now pins to $BUILDPLATFORM, fixing the emulated-arch abort that dropped the image from 2.3.1 · 2.3.1 stays as-is on npm, the MCP Registry…

04 · Who maintains Ntfy MCP Server

ntfy-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 119 actively maintained, 1,816 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/ntfy-mcp-server
category: other - ranked #51 of 945 actively-maintained other servers as of 2026-09-18.
release cadence: 7 releases in the last 90 days (latest 2026-09-16)
registry: io.github.cyanheads/ntfy-mcp-server (active, first published 2026-05-10 · 11 versions)
packages: npm:ntfy-mcp-server · npm:ntfy-mcp-server

06 · Ntfy MCP Server FAQ

Is Ntfy MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can Ntfy MCP Server do?

An agent gets 4 documented tools spanning ntfy, message, including ntfy_publish_message, ntfy_manage_message, ntfy_fetch_messages, ntfy_search_emoji_tags.

How do I install Ntfy MCP Server?

Run `npx -y ntfy-mcp-server`. The README documents 3 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, NTFY_DEFAULT_TOPIC) to set first. Set MCP_LOG_LEVEL, NTFY_DEFAULT_TOPIC before connecting. MCP_TRANSPORT_TYPE is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Ntfy MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ntfy MCP Server

Alternatives to Ntfy MCP Server

Maintained other servers if Ntfy MCP Server isn't the fit.

More MCP servers to compare · Openalex MCP Server · Openstates MCP Server · Orcid MCP Server · Paleobiology MCP Server · Protein MCP Server

More TypeScript MCP servers · Obsidian MCP Server · Oecd MCP Server · Open Meteo MCP Server · Openaq MCP Server · see all