ntfy-mcp-server

ntfy-mcp-server

3.2

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

  1. Install dependencies:
npm install --save-dev typescript @types/node ts-node
  1. Build the TypeScript code:
npm run build
  1. 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 to
  • message (required): The message content to send
  • title (optional): A title for the notification
  • priority (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 or personal-notifications
  • Anyone who knows your channel name can send messages to it, so choose wisely

Development

Build Scripts

  • npm run build - Compile TypeScript to JavaScript
  • npm run build:linux - Build and make executable on Linux
  • npm run build:windows - Build for Windows
  • npm start - Run the compiled server

Project Structure

  • - Main server implementation
  • - Compiled JavaScript output (after build)

License

See file for details.