ntfy-mcp

ntfy-mcp

Task completion notifications for AI assistants via ntfy.

43
Stars
4
Forks
43
Watchers
2
Issues
ntfy-mcp integrates with the Model Context Protocol to provide real-time notifications via ntfy when AI assistants complete tasks. It serves as an MCP server, keeping users informed without needing to constantly monitor progress. The application supports flexible configuration, is built in Node.js, and works seamlessly with the ntfy mobile app for simple, customizable push alerts.

Key Features

Real-time task completion notifications
Integration with the ntfy notification service
Full compatibility with Model Context Protocol
Node.js and TypeScript based build
Customizable configuration via environment variables
Easy setup and deployment
Works with ntfy mobile and desktop apps
Automatically notifies users upon task completion
Supports prompt-based notification triggers
Detailed step-by-step setup guide

Use Cases

Alerting users when code generation tasks are finished
Notifying about completion of AI-driven workflows
Enabling hands-free monitoring of AI assistant progress
Receiving push alerts for lengthy AI tasks
Enhancing productivity workflows for developers
Integrating task notification features into existing AI assistants
Providing remote task completion updates
Supporting team workflows by notifying collaborators of task completion
Automating deployment or testing notifications
Facilitating context-aware alerts for customized AI applications

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

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

Step 2: Install

bash
npm install

Step 3: Build

bash
npm run build

Step 4: Connect

Choose your adventure:

Manual Start:

bash
npm start

Cline Configuration:

json
"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

  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

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

Star History

Star History Chart

Repository Owner

teddyzxcv
teddyzxcv

User

Repository Details

Language JavaScript
Default Branch main
Size 41 KB
Contributors 1
License Apache License 2.0
MCP Verified Nov 11, 2025

Programming Languages

JavaScript
48.89%
TypeScript
47.24%
Dockerfile
3.87%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • @bldbl/mcp

    @bldbl/mcp

    Official MCP client for integrating AI assistants with Buildable projects.

    @bldbl/mcp enables AI assistants like Claude and GPT to directly interact with Buildable projects using the Model Context Protocol (MCP). It provides full project context, smart task management, real-time progress tracking, and facilitates seamless communication between AI and human developers. TypeScript support and CLI tools ensure robust integration, making it ready for platforms like Claude Desktop and Cursor AI. The tool simplifies AI-driven project management and collaboration in software development.

    • 8
    • MCP
    • chunkydotdev/bldbl-mcp
  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • 35
    • MCP
    • jen6/ticktick-mcp
  • Godot MCP

    Godot MCP

    A Model Context Protocol (MCP) server implementation using Godot and Node.js.

    Godot MCP implements the Model Context Protocol (MCP) as a server, leveraging the Godot game engine along with Node.js and TypeScript technologies. Designed for seamless integration and efficient context management, it aims to facilitate standardized communication between AI models and applications. This project offers a ready-to-use MCP server for developers utilizing Godot and modern JavaScript stacks.

    • 1,071
    • MCP
    • Coding-Solo/godot-mcp
  • Airtable MCP Server

    Airtable MCP Server

    Advanced AI-powered server enabling enterprise-grade automation and analytics for Airtable through MCP.

    Airtable MCP Server is an AI-enhanced MCP-compliant server designed to provide seamless integration with Airtable databases. It offers intelligent automation, predictive analytics, natural language querying, and comprehensive schema management, powered by a robust TypeScript architecture. The solution is equipped with multi-base support, enterprise-level security, and advanced governance, making it suitable for diverse workflow automation and analytics scenarios.

    • 45
    • MCP
    • rashidazarang/airtable-mcp
  • Mastra

    Mastra

    A TypeScript framework for building scalable AI-powered agents and applications.

    Mastra is a modern TypeScript-based framework designed for developing AI-powered applications and autonomous agents. It offers model routing to integrate over 40 AI providers, a graph-based workflow engine, advanced context management, and production-ready tools for observability and evaluation. Mastra features built-in support for authoring Model Context Protocol (MCP) servers, enabling standardized exposure of agents, tools, and structured AI resources via the MCP interface.

    • 18,189
    • MCP
    • mastra-ai/mastra
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results