What is Your Friendly Task Completion Notifier

ntfy-mcp is a server that sends notifications through the ntfy platform whenever tasks assigned to an AI assistant are completed. It leverages the Model Context Protocol to enhance productivity by keeping users informed about their tasks without disrupting their workflow.

Use cases

ntfy-mcp is particularly useful for developers and users who leverage AI to automate tasks. By providing real-time notifications, it allows users to multitask effectively, taking breaks or focusing on other work while still being updated about task completions.

How to use

To use ntfy-mcp, clone the repository, install the required dependencies, build the project, and start the server either manually or through configuration. Users can set a specific notification topic and make requests with prompts that include a notification command after task completion.

Key features

Key features of ntfy-mcp include seamless integration with the Model Context Protocol, customizable notifications through the ntfy app, and the ability to automate user notifications based on the completion of specific tasks, enhancing the overall user experience.

Where to use

ntfy-mcp can be used in various environments where task automation and notification are beneficial. This includes coding sessions, project management, or any situation where users require updates from AI task completions without needing to monitor the process constantly.

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:

Step 5: Get Notified in Style

1. Download the ntfy app on your phone
2. Subscribe to your chosen topic
3. 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

• @modelcontextprotocol/sdk
• node-fetch
• dotenv
• zod

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! 🎉