Ntfy MCP Server

● Active

io.github.cyanheads/ntfy-mcp-server

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

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-mcp-server@2.4.2"
      ],
      "env": {
        "NTFY_BASE_URL": "https://ntfy.sh",
        "NTFY_REQUEST_TIMEOUT_MS": "15000",
        "NTFY_MAX_RETRIES": "3",
        "NTFY_BLOCK_PRIVATE_HOSTS": "false",
        "NTFY_CLAMP_LIMITS": "true",
        "NTFY_ENABLE_EMOJI_TAGS": "true",
        "MCP_LOG_LEVEL": "info",
        "LOGS_DIR": "./logs",
        "OTEL_ENABLED": "false"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env NTFY_BASE_URL=https://ntfy.sh --env NTFY_REQUEST_TIMEOUT_MS=15000 --env NTFY_MAX_RETRIES=3 --env NTFY_BLOCK_PRIVATE_HOSTS=false --env NTFY_CLAMP_LIMITS=true --env NTFY_ENABLE_EMOJI_TAGS=true --env MCP_LOG_LEVEL=info --env LOGS_DIR=./logs --env OTEL_ENABLED=false --transport stdio ntfy-mcp-server -- npx -y ntfy-mcp-server@2.4.2
OpenAI Codex CLI
codex mcp add ntfy-mcp-server --env NTFY_BASE_URL=https://ntfy.sh --env NTFY_REQUEST_TIMEOUT_MS=15000 --env NTFY_MAX_RETRIES=3 --env NTFY_BLOCK_PRIVATE_HOSTS=false --env NTFY_CLAMP_LIMITS=true --env NTFY_ENABLE_EMOJI_TAGS=true --env MCP_LOG_LEVEL=info --env LOGS_DIR=./logs --env OTEL_ENABLED=false -- npx -y ntfy-mcp-server@2.4.2
VS Code
code --add-mcp '{"name":"ntfy-mcp-server","type":"stdio","command":"npx","args":["-y","ntfy-mcp-server@2.4.2"],"env":{"NTFY_BASE_URL":"https://ntfy.sh","NTFY_REQUEST_TIMEOUT_MS":"15000","NTFY_MAX_RETRIES":"3","NTFY_BLOCK_PRIVATE_HOSTS":"false","NTFY_CLAMP_LIMITS":"true","NTFY_ENABLE_EMOJI_TAGS":"true","MCP_LOG_LEVEL":"info","LOGS_DIR":"./logs","OTEL_ENABLED":"false"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • NTFY_BASE_URLSingle-server shorthand — base URL of the ntfy server (no trailing slash, no `user:password@`; set credentials with the NTFY_AUTH_* variables). Used when NTFY_SERVERS is unset.
  • NTFY_REQUEST_TIMEOUT_MSPer-attempt HTTP timeout in milliseconds, covering the response body. Each call is also capped at 50 s across all attempts.
  • NTFY_MAX_RETRIESMax retry attempts for transient upstream failures (5xx, network, 429).
  • NTFY_BLOCK_PRIVATE_HOSTSWhen true, a per-call `base_url` override must resolve to a public address and its redirects are not followed. Servers registered under NTFY_SERVERS / NTFY_BASE_URL are exempt. Turn it on where callers you do not control can reach the server.
  • NTFY_CLAMP_LIMITSWhen true, a `limit` above a tool's per-call cap (100 for ntfy_fetch_messages, 200 for ntfy_search_emoji_tags), or a `wait_seconds` above 40 on ntfy_fetch_messages, is served as the cap with a notice, and the input schema advertises no maximum. Set to false to advertise and enforce a schema maximum at the cap instead, so a larger value is rejected.
  • NTFY_ENABLE_EMOJI_TAGSSet to false to disable the ntfy_search_emoji_tags tool: it leaves tools/list, and the server instructions and ntfy_publish_message stop pointing at it.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • LOGS_DIRDirectory for file-based logs (Node only; ignored on Workers).
  • OTEL_ENABLEDEnable OpenTelemetry instrumentation (spans, metrics, completion logs).

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
2.4.2
Registry
active
Published
11/18/2026

On GitHub

read Nov 17, 2026
Stars
25
Forks
10
Last push
Nov 14, 2026
License
Apache-2.0

TypeScriptai-agentcyanheadsmcpmcp-servermodel-context-protocolnotificationsntfytypescript

From the README

ntfy-mcp-server Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP. 4 Tools • 1 Resource • 1 Skill Overview Push notifications to your phone or desktop through ntfy. Publish, update, and manage notifications, poll a topic's recent history, and look up emoji short codes for tags. Tools Resources ntfyfetchmessages covers the same topic data with custom windows and filters when the resource's fixed defaults aren't enough. Skills Plugin, npm, Docker, and MCPB installs ship it from skills/; MCP clients that support the Skills extension read it as skill://ntfy-guide/SKILL.md. Capability reference ntfypublishmessage tool • Topics are created on first publish — treat the topic name as a secret; anyone who knows it can publish or subscribe • Takes title, priority (1–5), tags, click, attach, icon, filename, markdown (rendered by the web app and the Android app), delay, timezone, email, call, cache, firebase, and up to three action buttons (view, broadcast, http, copy); body capped at 4096 bytes, empty body defaults to triggered; pass the original sequence_id to update a sent message • delay takes a duration, a Unix timestamp, an RFC 3339 time with its Z or ±hh:mm offset, or a natural-language time; ntfy reads a natural-language time in timezone (an IANA zone name) when set, otherwise in its own server's timezone.…

Read the full README on GitHub →

Alternatives to Ntfy MCP Server

Best Communication servers →

The most-starred Communication servers in the index, with their live-check result.

ServerStarsLast pushLive check
Inbox Zero13,026Nov 2026Needs sign-in
Agent-Native Brain7,707Nov 2026Needs sign-in
Agent-Native Chat7,707Nov 2026Needs sign-in
Agent-Native Dispatch7,707Nov 2026Needs sign-in
Agent-Native Mail7,707Nov 2026Needs sign-in

Ntfy MCP Server: questions people ask

Is Ntfy MCP Server a remote or a local MCP server?
According to its entry in the official MCP registry, Ntfy MCP Server ships as a local package (npm) that your client starts on your machine.
Does Ntfy MCP Server need an API key?
Its registry entry declares one required environment variable: MCP_REQUEST_STATE_KEY. The config on this page shows where each goes.
Is Ntfy MCP Server still maintained?
Active: the repository's last commit 5 days ago. Last push Nov 14, 2026, 25 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 17, 2026.
How do I add Ntfy MCP Server to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Communication →

Add the badge to your site

Show visitors that Ntfy MCP Server is listed here — it’s also the link we check for a free listing.

Ntfy MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-cyanheads-ntfy-mcp-server?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Ntfy MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Ntfy MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-cyanheads-ntfy-mcp-server?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.