ntfy-me-mcp

ntfy-me-mcp

AI-powered MCP server for real-time ntfy notifications to devices (public or self-hosted) with token support.

48
Stars
11
Forks
3
Releases

Overview

ntfy-me-mcp is a streamlined MCP server that enables AI assistants to send real-time ntfy notifications to devices, supporting both public ntfy.sh topics and self-hosted servers with token-based authentication. It exposes rich notification features via the MCP: topics, titles, priorities, emoji tags, and detailed message bodies, with automatic URL detection to create clickable view actions and intelligent markdown handling. Authentication is optional but supported; when PROTECTED_TOPIC is enabled or a token is provided, the server can authenticate protected topics or private servers. Tokens can be securely supplied via environment variables or via VS Code inputs (masked at entry). The solution is designed for quick setup: run with npx or Docker, or install and run locally, with clear MCP configuration examples for both direct token usage and secure token handling. It uses environment variables such as NTFY_TOPIC, NTFY_URL, NTFY_TOKEN, and PROTECTED_TOPIC to configure behavior. It also supports message retrieval (ntfy_me_fetch) for filtering cached messages from topics, and a built-in receiver setup workflow using the ntfy app. Self-hosted support and strong security are emphasized.

Details

Owner
gitmotion
Language
JavaScript
License
GNU General Public License v3.0
Updated
2025-12-07

Features

Quick Setup

Run with npx or Docker for fast MCP integration and minimal setup.

Real-time Notifications

Send real-time ntfy messages to devices when tasks complete or milestones are reached.

Rich Notifications

Support for topic, title, priorities, emoji tags, and detailed messages for rich content.

Notification Fetching

Fetch and filter cached messages from ntfy topics for convenient retrieval.

Smart Action Links

Automatically detects URLs in messages and creates up to 3 view actions.

Intelligent Markdown

Auto-detects markdown and enables parsing; supports manual override when needed.

Secure

Optional authentication with access tokens; supports PROTECTED_TOPIC mode.

Input Masking

Securely store your ntfy token in VS Code config with masking for safety.

Audience

AI developersEnable MCP-compatible assistants to send real-time ntfy notifications to devices (public or self-hosted) with token support.

Tags

ntfymcpnotificationsaiself-hostedtoken-authenticationdockernpxvscodemarkdownview-actionsemojiurl-detection