Awesome MCP › Social & Messaging

gitmotion/ntfy-me-mcp

⭐ 73 JavaScript added to this list on 2025-05-06 repository created 2025-04-10

ntfy-me-mcp is a Model Context Protocol server that gives an AI assistant a way to push notifications to the phone and desktop of its user through the ntfy service, so long-running work does not have to be watched. It works against the public ntfy.sh service or a self-hosted ntfy instance, with optional access token authentication for protected topics. The server exposes two tools. ntfy_me sends a notification and accepts a topic, title, message body, priority and emoji tags, and it is designed to be driven from natural language so the assistant can describe what happened without extra configuration. ntfy_me_fetch polls a topic and fetches cached messages with filtering, which lets the assistant read back what was sent. Two conveniences run automatically: URLs found in a message are detected and turned into view actions on the notification, and markdown formatting is enabled when the message text appears to contain markdown. Configuration is through environment variables covering the server URL, the default topic and the access token, and the README documents how to store the token as a masked input in a Visual Studio Code MCP configuration rather than in plain text. The server is distributed on npm and as a Docker image, so it can be started with npx or docker without a build step, and the README lists configuration examples for common clients along with instructions for setting up the receiving ntfy client. It is written in TypeScript and licensed GPL-3.0. The project lists planned additions including email delivery through an ntfy email server, customisable click URLs and automatic detection of image URLs. It suits developers who run agents on long tasks and want notifications of completion, errors or milestones.

https://github.com/gitmotion/ntfy-me-mcp

mcpmcp-servertypescriptntfynotificationspushself-hosteddocker