Simple Ntfy MCP Server

Simple Ntfy MCP Server

 

A simple MCP (Model Context Protocol) server for sending push notifications via ntfy.sh. Works seamlessly with Claude Desktop and other MCP-compatible clients.

Features

• Zero configuration - Works out of the box with npx
• Push notifications - Send notifications to any device via ntfy
• Lightweight - Minimal dependencies
• Customizable - Support for titles, priorities, tags, click actions, and action buttons

Installation & Usage

With npx (Recommended)

No installation needed! Just add to your Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ntfy": {
      "command": "npx",
      "args": ["-y", "simple-ntfy-mcp"],
      "env": {
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

Global Installation

npm install -g simple-ntfy-mcp

Then use in your Claude Desktop config:

{
  "mcpServers": {
    "ntfy": {
      "command": "simple-ntfy-mcp",
      "env": {
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

Configuration

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | NTFY_DEFAULT_TOPIC | Default topic to send notifications to | (required) | | NTFY_BASE_URL | Base URL of ntfy server | https://ntfy.sh |

Tool: send_ntfy

Send a push notification to your configured ntfy topic.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | message | string | ✅ | The notification message | | topic | string | ❌ | Topic to send to (uses default if not specified) | | title | string | ❌ | Notification title | | priority | number | ❌ | Priority level 1-5 (default: 3) | | tags | string[] | ❌ | Array of tags/emojis | | click | string | ❌ | URL to open when notification is clicked | | actions | object[] | ❌ | Action buttons |

Example Usage

Once configured, you can ask Claude to send you notifications:

"Send me a notification when you're done with this task"

Or be more specific:

"Send a high priority notification with the title 'Build Complete' and message 'Your project has finished building'"

Example Tool Call

{
  "message": "Your task is complete!",
  "title": "Task Completed",
  "priority": 4,
  "tags": ["white_check_mark", "rocket"],
  "click": "https://example.com"
}

What is ntfy?

ntfy is a simple HTTP-based pub-sub notification service. It allows you to send push notifications to your phone or desktop from any script or application. It's free, open source, and you can even self-host it.

To receive notifications:

1. Install the ntfy app on your Android or iOS device
2. Subscribe to your chosen topic
3. Configure this MCP server with the same topic name

License

MIT