notify
Send a simple notification with body, optional title, and optional template (e.g., 'status', 'question', 'progress', 'problem')
LABSCO SUMMARY
An outbound pipe set up once: the agent writes the message, never the address.
Because the destination lives in WEBHOOK_URL and WEBHOOK_TYPE rather than in the arguments, the agent cannot choose who to notify at call time — a server instance means a destination, fixed. That is also what makes it cheap to expose: the model decides what a notification says, and with full_notify what it links to, but never where it goes.
What it is
A webhook notifier for Discord, Slack, Microsoft Teams, Feishu, ntfy or a custom endpoint, with two tools, notify and full_notify, that post to the address in WEBHOOK_URL. Maintained by zudsniper as the successor to tuberrabbit's original project.
What you get
- Outbound notification from inside the agent: notify sends a message with an optional title and template, and full_notify adds a link and an image, plus a priority, attachments and action buttons on ntfy.
- A destination fixed by configuration rather than by argument: the address comes from WEBHOOK_URL and its kind from WEBHOOK_TYPE, so a call carries the message, never the destination.
Requirements
A webhook you can post to: its address in WEBHOOK_URL and its kind in WEBHOOK_TYPE.
Setup effort
One command plus credentials — npm install -g mcp-notifications, then supply credentials
USE CASES
01
Getting told when a long agent run has finished
Have the agent post its own completion notice to the channel you already watch, instead of leaving it for you to find.
2 tools
Listed in project code.
full_notify
Send a detailed notification with advanced options (link, image, priority, attachments, actions, template data)
BEFORE YOU INSTALL
What to know first
Tools you get
2 tools registered in the project's code.
Requires
- npx on PATH
- WEBHOOK_URL in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g mcp-notificationsMCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"notifier": {
"command": "npx",
"args": [
"-y",
"mcp-notifications"
],
"env": {
"WEBHOOK_URL": "https://ntfy.sh/webhook-url-example",
"WEBHOOK_TYPE": "ntfy"
}
}
}
}
