MCP Server Notifier
About
Lightweight Node.js server sending webhook notifications. Ideal for devs using AI agents (e.g., Cursor) on multi-projects, alerting task completion for efficient switching. Features webhook alerts, multi-project dev, AI integration, easy setup for dev tools & automation.
Details
- License
- MIT
Explore
- Webhook Notifications: Receive alerts when your AI agents complete tasks
- Multiple Webhook Providers: Support for Discord, Slack, Microsoft Teams, Feishu, Ntfy, and custom webhooks
- Image Support: Include images in notifications via Imgur
- Multi-Project Support: Efficiently manage notifications across different projects
- Easy Integration: Simple setup with AI tools like Cursor
- Customizable Messages: Send personalized notifications with title, body, and links
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server NotifierCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
By default, the notifier supports several webhook types:
- Discord
- Slack
- Microsoft Teams
- Feishu
- Ntfy
- Generic JSON
You can specify the webhook type and URL through environment variables:
env WEBHOOK_URL="https://your-webhook-url" WEBHOOK_TYPE="discord" npx -y mcp-server-notifier
docker run -e WEBHOOK_URL=https://your-webhook-url -e WEBHOOK_TYPE=discord zudsniper/mcp-server-notifier
WEBHOOK_TOKEN is an optional environment variable. When set, it will be included as a Bearer token in the Authorization header only for ntfy webhook requests. If WEBHOOK_TOKEN is not set, no Authorization header is sent.
- Basic Authentication is not supported.
- This token is ignored by all other webhook providers (Discord, Slack, Teams, Feishu, Generic JSON).
Example:
env WEBHOOK_URL="https://ntfy.sh/your-topic" WEBHOOK_TYPE="ntfy" WEBHOOK_TOKEN="your-secret-token" npx -y mcp-server-notifier
For more advanced configuration, you can create a webhook-config.json file:
{
"webhook": {
"type": "discord",
"url": "https://discord.com/api/webhooks/your-webhook-url",
"name": "My Notifier"
},
"imgur": {
"clientId": "your-imgur-client-id"
}
}
See the Configuration Guide for full details and examples.
Example webhook configurations are available in the examples directory.
1. Clone the repository:
git clone https://github.com/zudsniper/mcp-server-notifier.git
cd mcp-server-notifier
2. Install dependencies:
npm install
3. Build the project:
npm run build
```
npm install -g @modelcontextprotocol/inspector
message
Text content of the notification
title
(optional) - Title for the notification
link
(optional) - URL to include in the notification (used as click action for ntfy)
imageUrl
(optional) - URL of an image to include (legacy, use `image` or `attachments`)
image
(optional) - Local file path of an image to upload to Imgur
priority
(optional, ntfy only) - Notification priority (1-5)
attachments
(optional, ntfy only) - Array of URLs to attach
template
(optional, ntfy only) - Predefined template to use: status, question, progress, problem
templateData
(optional, ntfy only) - Data to populate the chosen template
actions
(optional, ntfy only) - Array of action button definitions (`view` or `http`)
1. notify
- Purpose: Send rich notifications to any configured webhook
- Input:
- message - Text content of the notification
- title (optional) - Title for the notification
- link (optional) - URL to include in the notification (used as click action for ntfy)
- imageUrl (optional) - URL of an image to include (legacy, use image or attachments)
- image (optional) - Local file path of an image to upload to Imgur
- priority (optional, ntfy only) - Notification priority (1-5)
- attachments (optional, ntfy only) - Array of URLs to attach
- template (optional, ntfy only) - Predefined template to use: status, question, progress, problem
- templateData (optional, ntfy only) - Data to populate the chosen template
- actions (optional, ntfy only) - Array of action button definitions (view or http)
- Best for: General notification needs
> Note: Template functionality is currently under development and has limited support. Templates work best with ntfy.sh but may not be fully implemented for all webhook providers. See the ROADMAP.md file for future implementation plans.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server notifier": {
"mcp-server-notifier": {
"command": "docker",
"args": [
"pull",
"zudsniper/mcp-server-notifier:latest"
]
}
}
}
}McpServers
{
"mcp-server-notifier": {
"command": "docker",
"args": [
"pull",
"zudsniper/mcp-server-notifier:latest"
]
}
}A lightweight notification service that integrates with MCP (Model Context Protocol) to send webhooks when AI agents complete tasks.
Authors
Originally created by [email protected]. Currently maintained by zudsniper.Features
- Webhook Notifications: Receive alerts when your AI agents complete tasks
- Multiple Webhook Providers: Support for Discord, Slack, Microsoft Teams, Feishu, Ntfy, and custom webhooks
- Image Support: Include images in notifications via Imgur
- Multi-Project Support: Efficiently manage notifications across different projects
- Easy Integration: Simple setup with AI tools like Cursor
- Customizable Messages: Send personalized notifications with title, body, and links
Installation
Option 1: Using npm
npm install -g mcp-server-notifier
Option 2: Using Docker
```bash
docker pull zudsniper/mcp-server-notifier:latest
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
