Skip to content
Agentmart
Submit a tool

Ntfy MCP Server

Send, manage, and replay ntfy push notifications.

Connector by cyanheads · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)Remote (HTTP)★ 23
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/cyanheads-ntfy-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
2 read · 1 write · 1 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 4

Read from the source code; the running server may list different tools.

Read 2 · Look things up without changing anything.

  • ntfy_fetch_messages
  • ntfy_search_emoji_tags

Write 1 · Create, change, send or run things.

  • ntfy_publish_message

Delete 1 · Delete, drop, revoke or wipe things.

  • ntfy_manage_message

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • NTFY_AUTH_PASSWORD
  • NTFY_AUTH_TOKEN

Other settings (environment variables or headers).

  • LOGS_DIR
  • MCP_LOG_LEVEL
  • NTFY_AUTH_USERNAME
  • NTFY_BASE_URL
  • NTFY_BLOCK_PRIVATE_HOSTS
  • NTFY_DEFAULT_TOPIC
  • NTFY_ENABLE_EMOJI_TAGS
  • NTFY_MAX_RETRIES
  • NTFY_REQUEST_TIMEOUT_MS
  • NTFY_SERVERS
  • OTEL_ENABLED

Tools (4)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • ntfy_fetch_messagesread-only

    Poll cached messages from one or more ntfy topics with optional filters. Returns a snapshot, not a live stream — use it to confirm delivery, replay missed alerts, or audit topic activity. Multiple topics are passed as a comma-separated list. One call returns the newest messages of the window; when more match, page through the whole window oldest-first by passing `nextCursor` back as `cursor`. Long bodies are truncated client-side to keep list responses bounded; refetch with that message `id` to read one in full.

  • ntfy_manage_messagecan change or delete data

    Clear (mark read & dismiss) or delete a previously-sent ntfy notification by `sequence_id`. Append-only: the original message stays in cache and a `message_clear`/`message_delete` event is emitted to subscribers. Re-issuing the same operation is safe — message state does not change, but a fresh event fires each time. ntfy.sh accepts unknown sequence IDs without error; stricter ntfy variants surface a `not_found` failure. The first call always asks the user to confirm the topic, `sequence_id`, and operation and comes back requesting that input rather than a result; reissue the same call with th…

  • ntfy_publish_message

    Description is built at runtime.

  • ntfy_search_emoji_tagsread-only

    Look up ntfy emoji tag short codes. Use the returned `tag` strings in `ntfy_publish_message`'s `tags` field to render emojis on the recipient's device. Without a query, returns the first slice of the full reference; pass a substring (e.g., `warning`, `tada`, `cd`) to filter, and `offset` to page through matches beyond `limit`.

Compare and alternatives

    Featured in

    Signals

    Stars
    23
    Forks
    10
    Open issues
    4
    Contributors
    2
    Last commit
    Oct 17, 2026 (11 days ago)
    Last release
    Oct 15, 2026 (13 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.cyanheads/ntfy-mcp-server
    Version
    2.3.7
    Auth
    API key
    Packages
    npm ntfy-mcp-servernpm ntfy-mcp-server
    License
    Apache-2.0
    Repository
    github.com/cyanheads/ntfy-mcp-server
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from cyanheads

    Cite this page

    Ntfy MCP Server. Agent Mart. https://agentmart.dev/connectors/cyanheads-ntfy-mcp-server (last updated 2026-10-24)