ntfy mcp
Enables AI agents to publish notifications, wait for replies, and read message history through the ntfy pub-sub notification service.
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., "@ntfy mcpSend a notification to my 'alerts' topic that the database is down."
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.
Warp, built for coding with multiple AI agents.
Available for MacOS, Linux, & Windows
This is axon β an AI-native fork of ntfy. It adds an optional AI layer on top of
vanilla ntfy. With AI disabled (ai-enabled: false), it behaves identically to upstream
ntfy and is a drop-in replacement. All credit for the underlying ntfy goes to
Philipp Heckel and the ntfy community β this fork
tracks binwiederhier/ntfy (Apache-2.0).
What axon adds today (all opt-in, local-first with Ollama):
π£οΈ AI subscription setup β describe what you want in plain language in the web app; the assistant proposes topics, filters and priorities for you to review and apply
π§ AI subscription tuning β "only page me for real emergencies at night"
βοΈ Inline enrichment β long alert messages get summarized into titles and an importance estimate, with instant pass-through when the AI is slow
π° Topic digests β "summarize the last 7 days" as a structured briefing
π¬ Ask your history β questions about a topic's recent messages, answered with citations to the actual messages
π€ MCP server for AI agents β
ntfy mcplets Claude & co. publish, wait for replies, and read history; scoped agent tokens included (ntfy token add --scope=ai)
Every AI call runs through a provider abstraction (OpenAI-compatible, Anthropic, Ollama), an LRU response cache, and per-visitor + global daily token budgets. See docs/ai-plan for the phased plan and docs/agents.md for the agent quickstart.
Install
Prebuilt static Linux binaries (amd64 + arm64, web app and docs embedded) are on the Releases page:
curl -LO https://github.com/mptfire/axon/releases/latest/download/axon-linux-amd64.gz
gunzip axon-linux-amd64.gz && chmod +x axon-linux-amd64 && sudo mv axon-linux-amd64 /usr/local/bin/axon
axon serve --listen-http :8080 # http://127.0.0.1:8080 β AI off (plain ntfy) until enabledTags matching v*-axon* automatically produce a release with binaries via GitHub Actions.

ntfy.sh | Send push notifications to your phone or desktop via PUT/POST
ntfy (pronounced "notify") is a simple HTTP-based pub-sub notification service. With ntfy, you can send notifications to your phone or desktop via scripts from any computer, without having to sign up or pay any fees. If you'd like to run your own instance of the service, you can easily do so since ntfy is open source.
You can access the free version of ntfy at ntfy.sh. There is also an open-source Android app available on Google Play or F-Droid, as well as an open source iOS app available on the App Store.
Related MCP server: NTFY MCP Server
ntfy Pro πΈ π
I now offer paid plans for ntfy.sh if you don't want to self-host, or you want to support the development of ntfy (β Purchase via web app). You can buy a plan for as low as $5/month. You can also donate via GitHub Sponsors, and Liberapay. I would be very humbled by your sponsorship. β€οΈ
Documentation
Getting started | Android/iOS | API | Install / Self-hosting | Building
Chat/forum
There are a few ways to get in touch with me and/or the rest of the community. Feel free to use any of these methods. Whatever works best for you:
Discord server - direct chat with the community
Matrix room #ntfy (+ Matrix space) - same chat, bridged from Discord
GitHub issues - questions, features, bugs
Announcements/beta testers
For announcements of new releases and cutting-edge beta versions, please subscribe to the ntfy.sh/announcements topic. If you'd like to test the iOS app, join TestFlight. For Android betas, join Discord/Matrix (I'll eventually make a testing channel in Google Play).
Sponsors
If you'd like to support the ntfy maintainers, please consider donating to GitHub Sponsors or and Liberapay. We would be humbled if you helped carry the server and developer account costs. Even small donations are very much appreciated.
Thank you to our commercial sponsors, who help keep the service running and the development going:
And a big fat Thank You to the individuals who have sponsored ntfy in the past, or are still sponsoring ntfy:
Contributing
I welcome any contributions. Just create a PR or an issue. For larger features/ideas, please reach out on Discord/Matrix first to see if I'd accept them. To contribute code, check out the build instructions for the server and the Android app. Or, if you'd like to help translate π©πͺ πΊπΈ π§π¬, you can start immediately in Hosted Weblate.
Code of Conduct
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
Please be sure to read the complete Code of Conduct.
License
Made with β€οΈ by Philipp C. Heckel.
The project is dual licensed under the Apache License 2.0 and the GPLv2 License.
Third-party libraries and resources:
github.com/urfave/cli (MIT) is used to drive the CLI
Mixkit sounds (Mixkit Free License) are used as notification sounds
Sounds from notificationsounds.com (Creative Commons Attribution) are used as notification sounds
Roboto Font (Apache 2.0) is used as a font in everything web
React (MIT) is used for the web app
Material UI components (MIT) are used in the web app
MUI dashboard template (MIT) was used as a basis for the web app
Dexie.js (Apache 2.0) is used for web app persistence in IndexedDB
GoReleaser (MIT) is used to create releases
go-smtp (MIT) is used to receive e-mails
stretchr/testify (MIT) is used for unit and integration tests
github.com/mattn/go-sqlite3 (MIT) is used to provide the persistent message cache
Firebase Admin SDK (Apache 2.0) is used to send FCM messages
github/gemoji (MIT) is used for emoji support (specifically the emoji.json file)
Go's text/template (BSD-3-Clause) is vendored under template/gotext/ with a small patch adding an execution deadline (see template/gotext/README.md)
Lightbox with vanilla JS as a lightbox on the landing page
HTTP middleware for gzip compression (MIT) is used for serving static files
Regex for auto-linking (MIT) is used to highlight links (the library is not used)
webpush-go (MIT) is used to send web push notifications
Sprig (MIT) is used to add template parsing functions
This server cannot be deployed
Maintenance
Related MCP Connectors
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
Async message queue for AI agents. Self-provision queues, push/poll messages, no signup.
Reach your own phone from an AI agent: notifications, approval questions, reminders, ring, files.
Collaboration layer for AI agents. Publish assets, send messages, manage threads and contacts.
Related MCP Servers
FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to interact with Novu's notification system, facilitating operations like sending notifications, managing subscribers, and organizing topics.4-- AlicenseAqualityDmaintenanceEnables bidirectional communication between AI agents and users through ntfy.sh push notifications, allowing agents to send messages and wait for user responses in asynchronous chat workflows.38 npm1MIT
- AlicenseBqualityDmaintenanceEnables AI agents to send push notifications to your phone through ntfy, with built-in security controls to prevent data exfiltration. It exposes a single tool notify_user for notifying when tasks complete or need attention.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables sending push notifications via ntfy with a single tool, allowing Claude agents to send notifications directly without shell access.MIT