Ntfy MCP

🚀 ntfy-mcp: Your Convenient Task Completion Notification Tool

ntfy-mcp is an MCP server that keeps you informed and on top of things! 🚀☕️

This compact and practical server seamlessly integrates with the Model Context Protocol. It immediately sends you notifications via ntfy when an AI assistant completes a task. After all, you deserve a break while your code is being written automatically.

🚀 Quick Start

Step 1: Clone and Navigate to the Directory

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

Step 2: Install Dependencies

npm install

Step 3: Build the Project

npm run build

Step 4: Start the Service

Choose your preferred method:

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 the best experience
  ]
}

Step 5: Set Up Stylized Notifications

1. Download the ntfy app on your phone.
2. Subscribe to the topic of your choice.
3. Relax and wait for notifications.

Step 6: Magic Commands

Write prompts like the following; otherwise, the function won't work properly. (Try using custom commands in cline, but they are at level 3, and the model might ignore them.)

Write a Python Hello World program for me and notify me when the task is completed.

Step 7: Enjoy Your Beverage of Choice

☕️🍵 You'll receive a notification when the task is done. Stay relaxed!

🔧 Technical Details

This MCP server seamlessly integrates with the Model Context Protocol, acting as your personal notification manager. It sends notifications via ntfy after a task is completed, keeping you informed without disrupting your workflow.

📦 Dependencies: The Secret Weapons

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

📄 License

This project is licensed under the Apache License 2.0. Please refer to the LICENSE file for specific terms.

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.

Now you can start coding with confidence, knowing your notifications are in good hands! 🎉