Ntfy MCP Server
by cyanheads
An MCP (Model Context Protocol) server designed to interact with the ntfy push notification service. It enables LLMs and AI agents to send notifications to your devices with extensive customization options.
Last updated: N/A
What is Ntfy MCP Server?
This server implements the Model Context Protocol (MCP), enabling standardized communication between LLMs and external systems. Specifically, it provides an interface to the ntfy push notification service, allowing LLM agents to send notifications to your devices without needing direct HTTP access.
How to use Ntfy MCP Server?
Install the server either globally via npm or from source by cloning the repository and building it. Configure the server using environment variables and add it to your MCP client settings (e.g., Cline VSCode extension or Claude Desktop App). Then, use the send_ntfy tool to send notifications with various customization options.
Key features of Ntfy MCP Server
MCP Server Implementation using @modelcontextprotocol/sdk
Ntfy Integration with message prioritization, emoji tags, clickable actions, file attachments, and delayed delivery
Resource Exposure of the configured default ntfy topic
TypeScript codebase with comprehensive type definitions
Structured Logging with winston and winston-daily-rotate-file
Configuration Management with dotenv
Error Handling & Security with input sanitization and security filters
Use cases of Ntfy MCP Server
Long-running Task Notifications
Scheduled Reminders
Alert Systems
Mobile Notifications from LLMs
Multi-step Process Updates
FAQ from Ntfy MCP Server
What is MCP?
What is MCP?
Model Context Protocol (MCP) is a protocol that enables standardized communication between LLMs and external systems.
What is ntfy?
What is ntfy?
Ntfy is a simple HTTP-based pub-sub notification service that allows you to send notifications to your phone or desktop via simple HTTP requests.
How do I configure the ntfy topic?
How do I configure the ntfy topic?
You can configure the ntfy topic using the NTFY_DEFAULT_TOPIC environment variable in the .env file.
How do I install the server?
How do I install the server?
You can install the server either globally via npm (npm install -g ntfy-mcp-server) or from source by cloning the repository and building it (npm install && npm run build).
How do I send a notification?
How do I send a notification?
You can use the send_ntfy tool with the appropriate arguments for topic, message, and other customization options.