Ntfy MCP Server

Ntfy MCP Server is an MCP server that connects large language models and autonomous agents to the ntfy push notification service, enabling devices to receive automated alerts and notifications directly from AI workflows. Software developers, system administrators, and automation engineers use it to integrate conversational clients such as Claude Desktop, Cursor, or VS Code with local or cloud-based ntfy topics. The server provides a suite of tools to publish new notifications with custom titles, priorities, emoji tags, attachments, and interactive action buttons. It also allows models to manage existing messages, dismiss or clear alerts by sequence identifier, and inspect cached topic histories without running separate scripts. Operators can configure public ntfy.sh servers or self-hosted instances using token or basic authentication, with built-in protections against server-side request forgery when overriding target hosts. In addition, user confirmation prompts ensure that critical actions like clearing messages or sending outbound calls and emails do not execute without deliberate consent, maintaining security across both STDIO and Streamable HTTP operational environments.

Category: Communication & Messaging

Tags: alerts, messaging, notifications, ntfy, push

Visit Ntfy MCP Server

How to install and configure Ntfy MCP Server

1. Verify that Bun v1.3.11 or higher (or Node.js v24+) is installed on your system. 2. Open your MCP client configuration file, such as Claude Desktop or Cursor settings. 3. Add the server entry under the mcpServers object: json { "mcpServers": { "ntfy-mcp-server": { "type": "stdio", "command": "bunx", "args": ["ntfy-mcp-server@latest"], "env": { "MCP_TRANSPORT_TYPE": "stdio", "MCP_LOG_LEVEL": "info", "NTFY_DEFAULT_TOPIC": "your-topic-name" } } } } 4. Replace your-topic-name with your target ntfy topic, and optionally define NTFY_AUTH_TOKEN or NTFY_BASE_URL if utilizing a self-hosted or protected instance. 5. Save the configuration file and restart your MCP client to register the tools.

What you can do with Ntfy MCP Server

• Dispatch real-time build notifications, test run summaries, or deployment alerts directly to mobile devices whenever an autonomous coding agent completes a task. - Query and filter recent notifications from multiple topic queues to audit missed alerts, review delivery timestamps, or inspect server operational history. - Add interactive action buttons to messages that let users trigger HTTP callbacks, open URLs, or broadcast intents directly from notification drawers. - Dismiss or clear obsolete notifications by sequence identifier to maintain clean device notification centers after resolving critical operational issues. - Search and insert ntfy emoji short codes into outgoing notification tags to improve the visual categorization and readability of incoming messages.

Key facts

• Open Source
• https://github.com/cyanheads/ntfy-mcp-server
• Communication & Messaging
• alerts, messaging, notifications, ntfy, push

Part of MCP Servers

What can Ntfy MCP Server do?

Ntfy MCP Server allows AI clients to publish, update, clear, and poll notifications through ntfy topics. It supports message formatting with markdown, priority levels from 1 to 5, attachments, custom icons, and interactive action buttons. Clients can also search bundled emoji tags and retrieve historical message snapshots across multiple topics.

How do I install Ntfy MCP Server?

You can configure the server in your MCP client by adding it to your configuration file with the command bunx and the argument ntfy-mcp-server@latest. Specify your topic using the NTFY_DEFAULT_TOPIC environment variable. You can also run the server via Docker using ghcr.io/cyanheads/ntfy-mcp-server:latest or start it over Streamable HTTP.

Which MCP clients work with Ntfy MCP Server?

Ntfy MCP Server functions with any MCP-compliant client that supports standard input/output (STDIO) or Streamable HTTP transports. Supported environments include Claude Desktop, Cursor, and VS Code. When using advanced outbound actions like email or phone calls, the client must be capable of presenting user confirmation prompts before executing requests.

Is Ntfy MCP Server open source?

Yes, Ntfy MCP Server is open-source software distributed under the Apache 2.0 license. The source code, issue tracker, and contribution guidelines are maintained publicly on GitHub in the cyanheads/ntfy-mcp-server repository. Anyone can inspect the code, contribute features, deploy self-hosted instances, or run the server across local and containerized environments.

Does Ntfy MCP Server require an account or authentication?

Using the public ntfy.sh service does not require an account or credentials for standard public topics. However, if you are publishing to protected topics on ntfy.sh or a self-hosted server, you can supply a bearer access token using NTFY_AUTH_TOKEN or configure basic HTTP credentials with NTFY_AUTH_USERNAME and NTFY_AUTH_PASSWORD.