ntfy-mcp

ntfy-mcp

The MCP server that keeps you informed by sending the notification on phone using ntfy

43
Stars
5
Forks
0
Releases

Overview

ntfy-mcp is an MCP server that acts as a notification butler for Model Context Protocol task completions. It integrates with MCP to detect when AI tasks finish and delivers alerts via the ntfy service to your mobile device, keeping you informed without interrupting your workflow. You can start it manually with npm start or configure it with a cline-style JSON snippet that specifies the command, build path, and environment variable NTFY_TOPIC to route messages to a chosen ntfy topic. Optional autoApprove allows automatically approving user notifications to streamline the experience. To receive notifications, install the ntfy mobile app and subscribe to your topic. The project relies on dependencies such as @modelcontextprotocol/sdk, node-fetch, dotenv, and zod. The README demonstrates a sample prompt that instructs the model to notify when a task completes. In short, ntfy-mcp provides a simple, mobile-friendly way to stay informed about model task outcomes by bridging MCP with ntfy.

Details

Owner
teddyzxcv
Language
JavaScript
License
Apache License 2.0
Updated
2025-12-07

Features

MCP Protocol Integration

The server integrates with Model Context Protocol to receive task results and trigger notifications.

NTFY-based Notifications

Sends task-completion alerts via the ntfy service to your mobile device.

Topic-based Routing

Configured through NTFY_TOPIC to route messages to a specific ntfy topic; subscribers can join.

Flexible Startup Options

Supports manual start (npm start) or cline-style configuration for automated startup.

Auto-Approve Notifications

Optional autoApprove setting enables automatic notification for specific events.

Simple Setup & Build

Install with npm install and build with npm run build for quick deployment.

Audience

DevelopersReceive mobile task completion notifications via ntfy by subscribing to a topic.
MCP usersGet task completion alerts sent to your mobile device via ntfy.
Product teamsStay informed on task progress with mobile ntfy notifications for completed tasks.

Tags

ntfyModel Context ProtocolTask CompletionNotificationsMobileNode.jsTypeScriptSDK