Connect Ntfy to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the publish message tool in Ntfy
Use the poll messages tool in Ntfy
Use the update notification tool in Ntfy
Use the get current user tool in Ntfy
Supported Tools
publish_message
Publish Message
Send a notification to an ntfy topic. Supports rich formatting including **titles**, **priorities**, **tags/emojis**, **Markdown**, **click actions**, **icons**, **attachments**, **action buttons**, **scheduled delivery**, **email forwarding**, and **phone calls**. Topics are created automatically on first use.
poll_messages
Poll Messages
Retrieve cached messages from an ntfy topic. Returns messages that have been published and are still cached on the server. Supports filtering by time, priority, tags, title, and message content.
update_notification
Update Notification
Update, clear, or delete a previously published notification using the first message ID or its stable sequence ID. Use this to replace a notification's content, dismiss it from the notification drawer, or remove it entirely.
get_current_user
Get Current User
Retrieve the connected ntfy username, role, account limits, usage statistics, and reserved topics. Anonymous connections return the server-provided anonymous identity and limits.
Enable Ntfy in Metorial. In your Metorial portal, enable the Ntfy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Ntfy tools.
Enable Ntfy in Metorial. In your Metorial portal, enable the Ntfy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Ntfy tools.
Enable Ntfy in Metorial. In your Metorial portal, enable the Ntfy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Ntfy tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Ntfy in Metorial. In your Metorial portal, enable the Ntfy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Ntfy tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Ntfy in Metorial. In your Metorial portal, enable the Ntfy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Ntfy tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Ntfy through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Ntfy and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Ntfy tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Send and poll push notifications using ntfy topics on ntfy.sh or a self-hosted server. Publish messages with titles, priorities, tags, Markdown, file URLs, and action buttons. Schedule notifications with an explicit timezone, update or dismiss notification sequences, forward messages to email or supported phone calls, and inspect the connected account and usage limits.
Frequently asked questions
Common questions about connecting Ntfy to AI agents with Metorial.
How many tools does the Ntfy MCP server have?
The Ntfy MCP server exposes 4 tools, including Publish Message, Poll Messages, Update Notification. Each one is governed and traced through Metorial.
Does the Ntfy MCP server support triggers?
Ntfy exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Ntfy MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ntfy MCP server through the same Metorial URL.
How do I give only some teams access to Ntfy?
Use role-based access control to decide which teams, users, and agents can use Ntfy and which of its tools they can call.
Can I self-host the Ntfy MCP server?
Yes. Metorial is open source, so you can run the Ntfy MCP server yourself or use the hosted gateway.
Connect Ntfy to production AI agents
See how Metorial gives your team governed access to Ntfy, with tracing and security controls built in.