ntfy-mcp

ntfy-mcp: Your Friendly Task Completion Notifier

Welcome to ntfy-mcp, the MCP server that keeps you caffeinated and informed! 🚀☕️

This handy little server integrates with the Model Context Protocol to send you delightful ntfy notifications whenever your AI assistant completes a task. Because let's face it - you deserve that tea break while your code writes itself.

Getting Started: The Quick Brew Guide

Step 1: Clone & Navigate

git clone https://github.com/teddyzxcv/ntfy-mcp.git
cd ntfy-mcp

Step 2: Install

npm install

Step 3: Build

npm run build

Step 4: Connect

Choose your adventure:

Manual Start:

npm start

Cline Configuration:

"ntfy-mcp": {
  "command": "node",
  "args": [
    "/path/to/ntfy-mcp/build/index.js"
  ],
  "env": {
    "NTFY_TOPIC": "<your topic name>"
  },
  "autoApprove": [
    "notify_user" // Highly recommended for maximum chill
  ]
}

Step 5: Get Notified in Style

Download the ntfy app on your phone
Subscribe to your chosen topic
Kick back and relax

Step 6: The Magic Command

Write a prompt like this, otherwise the function won't call (tried use Custom Instructions in cline, but they are in the ring 3, so model just forget about it)

Write me a hello world in python, notify me when the task is done

Step 7: Enjoy Your Beverage of Choice

☕️🍵 Your notification will arrive when the task is complete. No peeking!

How It Works (The Technical Tea)

This MCP server integrates seamlessly with the Model Context Protocol, acting as your personal notification butler. When tasks are completed, it sends notifications via ntfy, keeping you informed without interrupting your flow.

Dependencies: The Secret Sauce

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2025 Casey Hand @cyanheads

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Now go forth and code with confidence, knowing your notifications are in good hands! 🎉

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

The MCP server that keeps you informed by sending the notification on phone using ntfy.sh

Related Resources

Reddit Discussion about this server

Related MCP Servers

apple-notifier-mcp
turlockmike
A
security
A
license
A
quality
A simple MCP server that can send notifications on mac devices.
Last updated -
5
9
8
TypeScript
MIT License
mcp-ntopng
marcoeg
-
security
A
license
-
quality
MCP Server for networl monitoring software ntopng.
Last updated -
Python
MIT License
Twilio Messaging MCP Server
deshartman
-
security
F
license
-
quality
An MCP (Model Context Protocol) server that lets users send SMS messages through Twilio API directly from Claude Desktop via natural language commands.
Last updated -
1
TypeScript
NTFY MCP Server
cyanheads
-
security
A
license
-
quality
A Model Context Protocol server enabling AI systems to send real-time notifications to phones, desktops, and other devices through the ntfy publish/subscribe service.
Last updated -
18
7
TypeScript
Apache 2.0

View all related MCP servers

Appeared in Searches

How to get notifications for MCP on Mac and iPhone