Ntfy MCP Server
by cyanheads
An MCP 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) to provide an interface to the ntfy push notification service, allowing LLM agents to send notifications to devices without direct HTTP access.
How to use Ntfy MCP Server?
Install the server either globally via npm or from source. Configure the server with your ntfy topic and base URL in a .env file. Add the server to your MCP client settings (Cline or Claude Desktop) and then use the send_ntfy tool with the appropriate arguments to send notifications.
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
Configuration Management using 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 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.
What is MCP?
What is MCP?
MCP stands for Model Context Protocol. It enables standardized communication between LLMs and external systems.
How do I configure the ntfy topic?
How do I configure the ntfy topic?
You can configure the ntfy topic by setting 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?
Once the server is configured and running, you can use the send_ntfy tool with the appropriate arguments (topic, message, etc.) to send notifications.