Bring Push Notifications
to Claude Code
Learn how to connect ntfy (Push Notifications) to Claude Code and start using 2 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the ntfy (Push Notifications) MCP Server?
Connect your ntfy instance to any AI agent and manage real-time alerts and notifications through natural conversation. ntfy is an HTTP-based pub-sub service that allows you to send notifications to your phone or desktop via scripts or APIs.
What you can do
- Instant Publishing — Send messages to any ntfy topic with custom titles, priorities, and tags (emojis).
- Message Polling — Retrieve cached messages from a topic to stay updated on previous alerts or system logs.
- Rich Notifications — Attach clickable URLs, custom icons, and even files to your push notifications.
- Scheduled Alerts — Use the delay parameter to schedule notifications for the future.
- Advanced Formatting — Send notifications with Markdown support for better readability on supported clients.
How it works
- Subscribe to this server
- Enter your ntfy instance URL (e.g.,
https://ntfy.sh) and an optional access token - Start sending alerts from Claude, Cursor, or any MCP-compatible client
Who is this for?
- DevOps Engineers — Automate deployment alerts and system monitoring notifications directly from the terminal or IDE.
- Developers — Send debugging info or long-running task completions to your phone.
- Power Users — Create custom workflows that bridge AI agents with mobile push notifications without complex setups.
Built-in capabilities (2)
Poll cached messages from a ntfy topic
Topics are created on the fly. Publish a push notification to a ntfy topic
Why Claude Code?
Claude Code registers ntfy (Push Notifications) as an MCP server in a single terminal command. Once connected, Claude Code discovers all 2 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where ntfy (Push Notifications) data drives decisions without human intervention.
- —
Single-command setup:
claude mcp addregisters the server instantly. no config files to edit or applications to restart - —
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
- —
Claude Code runs headlessly, enabling unattended batch processing using ntfy (Push Notifications) tools in cron jobs or deployment scripts
- —
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
ntfy (Push Notifications) in Claude Code
ntfy (Push Notifications) and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect ntfy (Push Notifications) to Claude Code through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for ntfy (Push Notifications) in Claude Code
The ntfy (Push Notifications) MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 2 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Claude Code only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
ntfy (Push Notifications) for Claude Code
Every tool call from Claude Code to the ntfy (Push Notifications) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I send emojis in my notifications?
Yes! Use the tags parameter in the publish_message tool. You can provide a comma-separated list of emojis or tags like 'warning,skull' to display them in the notification.
How do I check for messages that were sent while I was away?
You can use the poll_messages tool. By specifying the topic and optionally the since parameter, you can retrieve the history of cached messages from that topic.
Does this support self-hosted ntfy instances?
Absolutely. During setup, you can provide your custom NTFY_URL. If your instance requires authentication, you can also provide your NTFY_TOKEN.
How do I add an MCP server to Claude Code?
Run claude mcp add <name> --transport http "<url>" in your terminal. Claude Code registers the server and discovers all tools immediately.
Can Claude Code run MCP tools in headless mode?
Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
How do I list all connected MCP servers?
Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.
Command not found: claude
Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
Connection timeout
Check your internet connection and verify the Edge URL is reachable
Explore More MCP Servers
View all →
Zoho Desk
13 toolsAI-powered helpdesk: manage tickets, contacts, and support workflows via agents.
Harvard WHO Health
16 toolsAccess WHO global health indicators, disease statistics, and population health data for evidence-based research and policy analysis.
Coassemble
8 toolsManage online training and LMS via Coassemble — track courses, monitor enrolments, and manage student groups directly from any AI agent.
Squarespace
6 toolsEquip your AI with read-only superpowers over your Squarespace platform. Scan transactions, track orders, and audit inventory effortlessly.