by teddyzxcv
Sends ntfy push notifications when an AI assistant finishes a task, enabling real‑time alerts without interrupting workflow.
Ntfy Mcp notifies you via ntfy whenever a task completed by an AI assistant reaches the end of its execution. It acts as a lightweight MCP server that bridges the Model Context Protocol with the ntfy notification service.
git clone https://github.com/teddyzxcv/ntfy-mcp.git
cd ntfy-mcp
npm install
npm run build
npm start
or run it through an MCP client configuration:
{
"ntfy-mcp": {
"command": "node",
"args": ["/path/to/ntfy-mcp/build/index.js"],
"env": {"NTFY_TOPIC": "<your topic name>"},
"autoApprove": ["notify_user"]
}
}
NTFY_TOPIC
environment variable to the ntfy topic you subscribe to.npm start
) or integrated MCP client configuration.NTFY_TOPIC
environment variable.notify_user
action for seamless alerts.@modelcontextprotocol/sdk
.Q: How do I set the ntfy topic?
A: Export NTFY_TOPIC
in your environment or add it to the MCP client config.
Q: Do I need to run the build step each time?
A: After code changes, yes. For regular use you can start the compiled version directly or use npx
as shown below.
Q: Can I run the server without building?
A: Yes, if you have ts-node
installed you can execute the source, but the recommended approach is the built JavaScript.
Q: What are the required dependencies?
A: Node.js (>=14), npm, and the packages listed in package.json
(@modelcontextprotocol/sdk
, node-fetch
, dotenv
, zod
).
Q: What license does the project use? A: Apache License 2.0.
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.
git clone https://github.com/teddyzxcv/ntfy-mcp.git
cd ntfy-mcp
npm install
npm run build
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
]
}
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
☕️🍵 Your notification will arrive when the task is complete. No peeking!
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.
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! 🎉
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "ntfy-mcp": { "command": "npx", "args": [ "-y", "ntfy-mcp" ], "env": { "NTFY_TOPIC": "<YOUR_TOPIC>" } } } }
Discover more MCP servers with similar functionality and use cases
by elie222
An AI‑powered email assistant that automates inbox management, enabling users to reach inbox zero fast by handling replies, labeling, archiving, unsubscribing, and providing analytics through a plain‑text prompt configuration.
by makenotion
Provides a remote Model Context Protocol server for the Notion API, enabling OAuth‑based installation and optimized toolsets for AI agents with minimal token usage.
by sooperset
MCP Atlassian is a Model Context Protocol (MCP) server that integrates AI assistants with Atlassian products like Confluence and Jira. It enables AI to automate tasks, search for information, and manage content within Atlassian ecosystems.
by ggozad
Interact with Ollama models through an intuitive terminal UI, supporting persistent chats, system prompts, model parameters, and MCP tools integration.
by nbonamy
A desktop AI assistant that bridges dozens of LLM, image, video, speech, and search providers, offering chat, generative media, RAG, shortcuts, and extensible plugins directly from the OS.
by GongRzhe
Provides tools for creating, editing, and enhancing PowerPoint presentations through a comprehensive set of MCP operations powered by python-pptx.
by GongRzhe
Creates, reads, and manipulates Microsoft Word documents through a standardized interface for AI assistants, enabling rich editing, formatting, and analysis capabilities.
by GongRzhe
Gmail-MCP-Server is a Model Context Protocol (MCP) server that integrates Gmail functionalities into AI assistants like Claude Desktop. It enables natural language interaction for email management, supporting features like sending, reading, and organizing emails.
by nspady
google-calendar-mcp is a Model Context Protocol (MCP) server that integrates Google Calendar with AI assistants. It enables AI assistants to manage Google Calendar events, including creating, updating, deleting, and searching for events.