ntfy-mcp-server
Send, manage, and replay ntfy push notifications via MCP.
Open the source (opens github.com) https://github.com/cyanheads/ntfy-mcp-server
Before you use it
- Runs on your computer with your permissions. Read what it can do before connecting it to an agent.
- Needs credentials: MCP_REQUEST_STATE_KEY. Use a key with the least access you can.
What it is
MCP servers from io.github.cyanheads.
The problem it solves and who it suits haven't been reviewed by InnerVault. The description above is the source's own.
How to get it
npm package (stdio)
ntfy-mcp-server@2.4.1
From the server's entry in the official MCP Registry
npm package (streamable-http)
ntfy-mcp-server@2.4.1
From the server's entry in the official MCP Registry
Settings it asks for
NTFY_SERVERS· JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the…NTFY_BASE_URL· Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.NTFY_DEFAULT_TOPIC· Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.NTFY_AUTH_TOKEN· Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.NTFY_AUTH_USERNAME· Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.NTFY_AUTH_PASSWORD· Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.NTFY_REQUEST_TIMEOUT_MS· Per-attempt HTTP timeout in milliseconds, covering the response body. Each call is also capped at 50 s across all attempts.NTFY_MAX_RETRIES· Max retry attempts for transient upstream failures (5xx, network, 429).NTFY_BLOCK_PRIVATE_HOSTS· When 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_CLAMP_LIMITS· When true, a `limit` above a tool's per-call cap (100 for ntfy_fetch_messages, 200 for ntfy_search_emoji_tags) is served as the cap with a notice, and the…NTFY_ENABLE_EMOJI_TAGS· Set 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_LEVEL· Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Related
-
GitHub MCP server
MCP serversGitHub's official MCP server. It lets an agent read and work with repositories, issues and pull requests.
https://api.githubcopilot.com/mcp/ -
Apify MCP server
MCP serversLets an agent run Apify's ready-made scrapers to pull data from websites, search engines, maps and social platforms.
-
Official MCP Registry
MCP serversThe MCP project's own registry of public MCP servers, so you can look for a connector before building one.
-
MCP reference servers
MCP serversSmall example servers from the MCP project (filesystem, git, fetch, memory and more) that show how MCP works.
-
Connect MCP servers to Claude Code
MCP serversAnthropic's guide to adding MCP servers to Claude Code, with examples of local and remote servers.
-
Playwright MCP
MCP serversLets an agent drive a real browser: open pages, click, fill in forms and read what's on screen.
claude mcp add playwright npx @playwright/mcp@latest