A
licenseB
qualityD
maintenanceMCP server for sending Gotify push notifications to your devices.
1
MIT
mcp-ntfy
by mambucodev
Send and poll push notifications via ntfy.sh, with support for custom topics, priorities, tags, actions, scheduling, message filtering, and server health checks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-ntfy Send a push notification saying 'Hello' to my topic"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-ntfy
MCP server for ntfy push notifications. Send and poll notifications from any MCP-compatible client.
Installation
npx mcp-ntfyRelated MCP server: ntfy-mcp
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ntfy": {
"command": "npx",
"args": ["-y", "mcp-ntfy"],
"env": {
"NTFY_URL": "https://ntfy.sh",
"NTFY_TOKEN": "tk_...",
"NTFY_TOPIC": "my-notifications"
}
}
}
}Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"ntfy": {
"command": "npx",
"args": ["-y", "mcp-ntfy"],
"env": {
"NTFY_URL": "https://ntfy.sh",
"NTFY_TOKEN": "tk_...",
"NTFY_TOPIC": "my-notifications"
}
}
}
}Environment Variables
Variable | Required | Default | Description |
| No |
| ntfy server base URL |
| No | — | Bearer token for authentication |
| No | — | Default topic (used when tool calls omit topic) |
Tools
publish
Send a push notification to an ntfy topic.
Parameter | Type | Required | Description |
| string | No* | Topic name (*required if |
| string | Yes | Notification body |
| string | No | Notification title |
| number | No | 1=min, 2=low, 3=default, 4=high, 5=urgent |
| string[] | No | Emoji shortcodes, e.g. |
| string | No | URL to open on tap |
| string | No | File URL to attach |
| string | No | Attachment filename |
| string | No | Notification icon URL |
| string | No | Delay: |
| boolean | No | Enable Markdown formatting |
| Action[] | No | Up to 3 action buttons |
poll
Poll for cached messages from an ntfy topic.
Parameter | Type | Required | Description |
| string | No* | Topic to poll (*required if |
| string | No | Duration ( |
| boolean | No | Include scheduled messages |
| string | No | Filter by message ID |
| string | No | Filter by message text |
| string | No | Filter by title |
| string | No | Filter by priority (comma-separated) |
| string | No | Filter by tags (comma-separated, AND logic) |
server_health
Check ntfy server health status and message statistics. No parameters.
License
MIT
Available Tools
3 toolspollPoll MessagesB
Poll for cached messages from an ntfy topic.
Inputs: id, tags, since, title, +5 more.
publishPublish NotificationA
Send a push notification to an ntfy topic.
Inputs: message (required), icon, tags, click, +9 more.
server_healthServer HealthB
Check ntfy server health status and message statistics.
Inputs: server.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A3.6/5.0
Scored across 3 tools
Disambiguation5/5
Each tool targets a distinct operation: publishing notifications, polling cached messages, and checking server health. There is no overlap or ambiguity between them.
Naming Consistency4/5
publish and poll follow a clear verb pattern, while server_health is a noun phrase rather than a verb-based action. The naming is mostly consistent and intuitive, with only a minor deviation.
Tool Count5/5
Three tools is well-scoped for an ntfy integration: send, receive, and health check. Each tool earns its place without unnecessary bulk.
Completeness4/5
The core notification lifecycle is covered: publishing, retrieving messages, and verifying server status. Real-time subscription is not included, but polling cached messages covers the main retrieval use case adequately.
Maintenance
ActivityInactive
ResponsivenessOutdated data
Related MCP Connectors
MCP server for OnceAsk, the AI-native current-address layer for people and agents.
MCP server for Ably — channel history, presence, occupancy, stats, publish, and app management.
MCP server for MailTempo's public free temporary email inboxes.
MCP server wrapping the Tesla Fleet API and TeslaMate API
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP server for sending notifications to ntfy.sh or self-hosted ntfy instances.216 npmMIT
- AlicenseBqualityDmaintenanceA lightweight MCP server for sending push notifications via ntfy.sh, supporting customizable titles, priorities, tags, and action buttons.14 npm7MIT
- AlicenseNot gradedqualityCmaintenanceMCP server and CLI for Gotify that lets agents send push notifications, check server health, list messages, and manage Gotify apps and clients over stdio or streamable HTTP, with authentication support.2AGPL 3.0