AI Atlas

Communication · Developer Tools

Ntfy MCP Server logo

Ntfy MCP Server

cyanheads/ntfy-mcp-server

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

View on GitHub6

Install

bunx ntfy-mcp-server@latest

Client configuration

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "bunx",
      "args": [
        "ntfy-mcp-server@latest"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
      }
    }
  }
}

Environment variables

MCP_TRANSPORT_TYPEMCP_LOG_LEVELNTFY_DEFAULT_TOPIC
GitHub stars
6
Author
@cyanheads
Category
Communication, Developer Tools
License
Apache-2.0
Updated
Oct 6, 2026

About Ntfy MCP Server

Push notifications over the ntfy pub/sub HTTP API. Publish, update, and manage notifications, poll cached topic history, and look up emoji short codes for tags from any MCP client. Runs as a stdio process or a local Streamable HTTP server.

Features

  • Wraps ntfy's HTTP API with a retry-aware client (withRetry + per-request timeout)

  • Per-server scoped auth — credentials bind to each registered base URL (NTFY_BASE_URL or an NTFY_SERVERS entry); mutually-exclusive bearer-token / basic-auth modes validated at config load; a per-call…

  • User confirmation before side effects that leave the notification drawer — a clear/delete, or a publish carrying email, call, or a broadcast/http action button — enforced on both stdio and Streamable…

  • Optional SSRF guard on base_url overrides (NTFY_BLOCK_PRIVATE_HOSTS) — blocks loopback, RFC 1918, RFC 6598 mesh, link-local, and IPv6 equivalents, then refuses redirects; registered servers are exempt

  • Bundled emoji-tag reference, regenerated from upstream docs/ntfy/emojis.md via scripts/build-emoji-tags.ts

  • Provenance — ntfy_publish_message and ntfy_manage_message echo back the resolved topic, ID, and timestamp; ntfy_fetch_messages also echoes the resolved since and applied filters

  • Discriminated outputs — typed reason codes (consent_declined, forbidden_topic, rate_limited, not_found, payload_too_large, and more) on every tool's error contract let callers branch on failure mode…

  • Truncation and paging guidance — ntfy_fetch_messages and ntfy_search_emoji_tags report a truncated flag plus a notice naming the exact next step (widen since, raise limit, advance offset) instead of…

Tools (5)

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

  • operation

    clear marks the notification read & dismisses it (subscribers see message_clear); delete removes it from the drawer (subscribers see message_delete)

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication