ntfy-mcp: Your Friendly Task Completion Notifier

1# ntfy-mcp: Your Friendly Task Completion Notifier
2 
3Welcome to ntfy-mcp, the MCP server that keeps you caffeinated and informed! 🚀☕️
4 
5This 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.
6 
7<a href="https://glama.ai/mcp/servers/@teddyzxcv/ntfy-mcp">
8  <img width="380" height="200" src="https://glama.ai/mcp/servers/@teddyzxcv/ntfy-mcp/badge" />
9</a>
10 
11## Getting Started: The Quick Brew Guide
12 
13### Step 1: Clone & Navigate
14```bash
15git clone https://github.com/teddyzxcv/ntfy-mcp.git
16cd ntfy-mcp
17```
18 
19### Step 2: Install 
20```bash
21npm install
22```
23 
24### Step 3: Build 
25```bash
26npm run build
27```
28 
29### Step 4: Connect
30Choose your adventure:
31 
32**Manual Start:**
33```bash
34npm start
35```
36 
37**Cline Configuration:**
38```json
39"ntfy-mcp": {
40  "command": "node",
41  "args": [
42    "/path/to/ntfy-mcp/build/index.js"
43  ],
44  "env": {
45    "NTFY_TOPIC": "<your topic name>"
46  },
47  "autoApprove": [
48    "notify_user" // Highly recommended for maximum chill
49  ]
50}
51```
52 
53### Step 5: Get Notified in Style
541. Download the [ntfy app](https://ntfy.sh) on your phone
552. Subscribe to your chosen topic
563. Kick back and relax
57 
58### Step 6: The Magic Command
59Write a prompt like this, otherwise the function won't call 
60(tried use `Custom Instructions` in cline, but they are in the ring 3, so model just forget about it)
61```
62Write me a hello world in python, notify me when the task is done
63```
64 
65### Step 7: Enjoy Your Beverage of Choice
66☕️🍵 Your notification will arrive when the task is complete. No peeking!
67 
68## How It Works (The Technical Tea)
69 
70This 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.
71 
72## Dependencies: The Secret Sauce
73 
74- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
75- [node-fetch](https://github.com/node-fetch/node-fetch)
76- [dotenv](https://github.com/motdotla/dotenv)
77- [zod](https://github.com/colinhacks/zod)
78 
79 
80 
81## License
82 
83This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
84 
85```
86Copyright 2025 Casey Hand @cyanheads
87 
88Licensed under the Apache License, Version 2.0 (the "License");
89you may not use this file except in compliance with the License.
90You may obtain a copy of the License at
91 
92    http://www.apache.org/licenses/LICENSE-2.0
93 
94Unless required by applicable law or agreed to in writing, software
95distributed under the License is distributed on an "AS IS" BASIS,
96WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
97See the License for the specific language governing permissions and
98limitations under the License.
99```
100 
101---
102 
103Now go forth and code with confidence, knowing your notifications are in good hands! 🎉
104