Ntfy MCP Server

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

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-22 · ★ 20 · #96 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

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

v2.3.1 · 2026-08-22

mcp-ts-core 0.12.3 (MCP SDK v2) and stateful sessions everywhere · Consent gate rewritten to the multi-round-trip requestInput/inputs flow, reaching Streamable HTTP clients that previously fell through the…

v2.3.0 · 2026-07-30

SSRF guard for base_url overrides, consent gate for destructive/side-effect calls · base_url overrides on all three tools now validated as absolute http(s) URLs; an opt-in NTFY_BLOCK_PRIVATE_HOSTS (off by default)…

04 · Who maintains Ntfy MCP Server

ntfy-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 124 actively maintained, 1,730 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 #96 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 7 releases in the last 90 days (latest 2026-08-22)
registry: io.github.cyanheads/ntfy-mcp-server (active, first published 2026-05-10 · 9 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-08-25, its last commit was 2026-08-22 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 · Orcid MCP Server · Paleobiology MCP Server · Protein MCP Server · Ris Austria MCP Server

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