ntfy-mcp-server
If you are the rightful owner of ntfy-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcpreview.com.
The ntfy-mcp-server is a Model Context Protocol (MCP) server designed to facilitate communication and data exchange between different systems using the MCP framework.
ntfy MCP Server
A Model Context Protocol (MCP) server that enables AI assistants to send push notifications through ntfy.sh. This server provides a simple way to integrate real-time notifications into your AI workflows, allowing you to receive alerts on your phone, desktop, or any device that supports ntfy.sh.
What is ntfy.sh?
ntfy.sh is a simple HTTP-based pub-sub notification service that allows you to send push notifications to your devices. It's particularly useful for:
- Getting notified when long-running tasks complete
- Receiving alerts from automated workflows
- Staying informed about important events in your applications
Features
- Send messages to any ntfy.sh channel
- Support for message titles, priorities (1-5), and tags
- Simple integration with MCP-compatible AI assistants
- No authentication required for public channels
Installation
- Install dependencies:
npm install --save-dev typescript @types/node ts-node
- Build the TypeScript code:
npm run build
- The MCP server is now available at
./build/index.js
Usage
Running the Server
After building, you can run the server directly:
npm start
Or point your MCP client to the built server at ./build/index.js
.
Available Tools
The server provides one tool:
send_message
Sends a message to a specified ntfy.sh channel.
Parameters:
channel
(required): The ntfy.sh channel name to send the message tomessage
(required): The message content to sendtitle
(optional): A title for the notificationpriority
(optional): Priority level from 1-5 (5 being highest priority)tags
(optional): Array of tags to categorize the message
Example usage in an MCP client:
{
"tool": "send_message",
"arguments": {
"channel": "my-notifications",
"message": "Task completed successfully!",
"title": "Workflow Update",
"priority": 4,
"tags": ["automation", "success"]
}
}
Configuration
No additional configuration is required. The server uses the public ntfy.sh service at https://ntfy.sh/
.
Channel Names
- Channel names can be any string, but should be unique to avoid conflicts
- Consider using descriptive names like
my-project-alerts
orpersonal-notifications
- Anyone who knows your channel name can send messages to it, so choose wisely
Development
Build Scripts
npm run build
- Compile TypeScript to JavaScriptnpm run build:linux
- Build and make executable on Linuxnpm run build:windows
- Build for Windowsnpm start
- Run the compiled server
Project Structure
- - Main server implementation
- - Compiled JavaScript output (after build)
License
See file for details.