ntfy-me-mcp logo

ntfy-me-mcp

by gitmotion

ntfy-me-mcp is a streamlined Model Context Protocol (MCP) server that enables AI assistants to send real-time notifications to your devices via the ntfy service. It allows you to receive updates when your AI completes tasks, encounters errors, or reaches important milestones.

View on GitHub

Last updated: N/A

What is ntfy-me-mcp?

ntfy-me-mcp is an MCP server designed to facilitate sending notifications from AI assistants to users' devices using the ntfy service.

How to use ntfy-me-mcp?

The server can be configured using NPM/NPX or Docker. You need to configure your MCP to use the server, providing the necessary environment variables such as NTFY_TOPIC, NTFY_URL, and NTFY_TOKEN. Once configured, AI assistants can send notifications by calling the ntfy_me tool with parameters like taskTitle, taskSummary, priority, and tags.

Key features of ntfy-me-mcp

  • Quick Setup with npx or Docker

  • Real-time Notifications

  • Rich Notifications with topic, title, priorities, emoji tags, and detailed messages

  • Optional authentication with access tokens

  • Secure token handling with VS Code input masking

  • Self-hosted ntfy instance support

Use cases of ntfy-me-mcp

  • Receive notifications when AI tasks are completed

  • Get alerts for errors encountered by AI assistants

  • Track important milestones in AI workflows

  • Monitor the progress of long-running AI processes

FAQ from ntfy-me-mcp

What is ntfy?

ntfy is a service that allows you to send push notifications to your phone or desktop via a simple HTTP request.

How do I set up a protected topic?

You need to configure the NTFY_URL and NTFY_TOKEN environment variables in your MCP server configuration.

Can I use this with a self-hosted ntfy instance?

Yes, you can configure the NTFY_URL environment variable to point to your self-hosted ntfy instance.

How do I use emoji shortcodes?

You can include emoji shortcodes in the tags array of your notification parameters. See the ntfy documentation for a full list of supported emoji shortcodes.

How do I install the ntfy app?

You can download the ntfy app from the ntfy website (ntfy.sh/app) or your device's app store.