About teddyzxcv/ntfy-mcp
teddyzxcv/ntfy-mcp is an MCP server published by teddyzxcv in the Developer Tools category: a quick and lightweight MCP server for ntfy.
The repository has 45 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/teddyzxcv/ntfy-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (1)
notify_userNotify the user that certain task is complete/error/stopped and give the summary and title of the completed task
Parameters not published.
Ask AI
Ask AI about teddyzxcv/ntfy-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 9 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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! 🎉
README fetched from the repository 9 days ago. The original is authoritative.