Ntfy MCP Server
● Activeio.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.
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"
}
}
}
}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.2codex 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.2code --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.
- 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.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Inbox Zero | 13,026 | Nov 2026 | Needs sign-in |
| Agent-Native Brain | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Chat | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Dispatch | 7,707 | Nov 2026 | Needs sign-in |
| Agent-Native Mail | 7,707 | Nov 2026 | Needs 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.
More Communication servers
Browse all Communication →Mailvett: Email Validation API for AI Agents
CyberMax-tools
Mailvett: validate emails. MX, provider, disposable/role/free flags, typo fix, verdict.
Letterkeel: Send Email via SMTP, Resend, SendGrid & Mailgun
CyberMax-tools
Letterkeel: send email from your own domain via SMTP, Resend, SendGrid, Mailgun, Postmark
Hollerdex: Website Contact Finder (Emails, Phones & Socials)
CyberMax-tools
Hollerdex: a domain's public emails, phones and social profiles as one ranked contact card.
Telegram Bot MCP Server
cyuanxv
Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.
HeyLead — AI agent for LinkedIn outreach
D4umak
AI agent for LinkedIn outreach: finds the right people, writes in your voice, follows up, replies.
MCP Telegram Bot
daedalus
MCP server that exposes a Telegram bot
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.
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
[](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.