A
securityA
licenseA
qualityEnables interaction with Slack workspaces as a user, supporting channel listing, message posting, threading, reactions, and user management via the Slack API.
Last updated -
8
MIT License
The notify_me_mcp server enables AI agents and LLMs to send rich notifications to Discord and Slack webhooks with robust security and handling.
Core Features:
Send Notifications: Dispatch plain text or rich formatted messages (Discord embeds, Slack blocks/attachments) to Discord, Slack, or both platforms simultaneously
Test Webhooks: Validate webhook connectivity by sending test messages to configured services
List Services: Retrieve configured webhook services and identify auto-detected defaults
Multi-service Support: Target specific services or all configured platforms with automatic service detection
Advanced Capabilities:
Customization Options: Override display usernames, avatar/icon URLs, and enable text-to-speech (TTS) for Discord
Rate Limit Handling: Automatic retry with exponential backoff for HTTP 429 responses
Security: Webhook URLs never exposed in logs, with comprehensive input validation and schema enforcement
Intelligent Defaults: Automatically chooses available services when unspecified, falling back to Discord if both are configured
notify_me_mcp
TypeScript MCP server for sending notifications to Discord and/or Slack webhooks
A powerful Model Context Protocol (MCP) server that provides webhook notification capabilities to AI agents and LLM applications. Send rich notifications to Discord and Slack with automatic service detection, retry logic, and comprehensive security features.
✨ Features
🔧 Three MCP Tools:
send_notification,validate_webhook,list_services🎯 Multi-Service Support: Discord, Slack, or both simultaneously
🛡️ Security First: Webhook URLs never exposed in logs or process lists
📱 Rich Content: Discord embeds and Slack blocks/attachments support
🔄 Robust Retry Logic: Handles rate limiting with exponential backoff
⚡ Service Auto-Detection: Automatically selects available services
🔍 Input Validation: Comprehensive schema validation with Zod
📊 Structured Logging: Secure logging with automatic URL redaction
🚀 Quick Start
Prerequisites
Node.js ≥ 23.7.0
npm ≥ 10.9.2
Discord and/or Slack webhook URLs
Installation
Clone the repository
git clone https://github.com/thesammykins/notifyme_mcp.git cd notifyme_mcpInstall dependencies
npm installConfigure webhooks
cp .env.example .env # Edit .env and replace webhook placeholdersBuild the project
npm run build
Configuration
Create a .env file with your webhook URLs:
# Discord webhook URL (optional)
DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"
# Slack webhook URL (optional)
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/T00/B00/XXXX"
# Optional: Custom .env file location
# NOTIFY_ME_ENV_FILE="/path/to/custom/.env"
# NOTIFY_ME_ENV_DIR="/path/to/directory"
Getting Webhook URLs:
Discord:
Go to Server Settings → Integrations → Webhooks
Click "Create Webhook" → Copy webhook URL
Slack:
Create a Slack app at https://api.slack.com/apps
Enable "Incoming Webhooks" → Add to workspace
Copy the webhook URL
🔧 Usage with MCP Clients
Claude Desktop Configuration
Add to your Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"notify_me_mcp": {
"command": "node",
"args": ["path/to/notifyme_mcp/dist/index.js"],
"env": {
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url",
"SLACK_WEBHOOK_URL": "your_slack_webhook_url"
}
}
}
}
Other MCP Clients
Use the built server at dist/index.js with any MCP-compatible client over stdio transport.
🛠️ Available Tools
send_notification
Send notifications to Discord and/or Slack webhooks.
Parameters:
message(string, optional): Plain text messageservice(string, optional): "discord", "slack", or "both" (auto-detected if not specified)embed_json(object/array/string, optional): Rich content (Discord embeds, Slack blocks)username(string, optional): Override display usernameavatar_url(string, optional): Override avatar/icon URLtts(boolean, optional): Enable text-to-speech (Discord only)
Examples:
// Simple notification
{"message": "Task completed successfully ✅"}
// Target specific service
{"message": "Deploy finished", "service": "slack", "username": "CI Bot"}
// Discord embed
{
"service": "discord",
"embed_json": {
"title": "Build Status",
"description": "All tests passed",
"color": 65280
}
}
// Slack blocks
{
"service": "slack",
"embed_json": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Deploy Complete* 🚀\nAll systems operational"
}
}
]
}
validate_webhook
Test webhook connectivity by sending a test message.
Parameters:
service(string, optional): "discord", "slack", or "both"message(string, optional): Custom test message
list_services
List configured webhook services and auto-detected default.
No parameters required.
🏗️ Service Auto-Detection
The server automatically detects which services to use:
Only Discord configured →
discordOnly Slack configured →
slackBoth configured →
discord(default for backward compatibility)Use → Send to all configured services
🔒 Security Features
Webhook Protection: URLs never appear in logs, errors, or process lists
Secure Logging: Automatic redaction of sensitive information
Input Validation: All inputs validated with Zod schemas
Rate Limiting: Automatic retry on 429 responses with
Retry-AftersupportTemporary Files: Created with restrictive permissions (077)
🎨 Rich Content Support
Discord Embeds
Supports Discord's native embed objects:
{
"title": "Deployment Status",
"description": "Production deployment completed",
"color": 65280,
"fields": [
{"name": "Version", "value": "v1.2.3", "inline": true},
{"name": "Duration", "value": "3m 42s", "inline": true}
],
"timestamp": "2024-01-15T10:30:00.000Z"
}
Slack Blocks & Attachments
Supports Slack's block kit and legacy attachments:
// Blocks (recommended)
[
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Deployment Complete* 🚀\nVersion v1.2.3 deployed successfully"
}
}
]
// Attachments (legacy)
{
"attachments": [
{
"color": "good",
"title": "✅ Success",
"text": "All tests passed",
"fields": [
{"title": "Environment", "value": "Production", "short": true}
]
}
]
}
📊 Common Colors
Status | Discord (decimal) | Slack (hex/keyword) |
Success |
|
or
|
Error |
|
or
|
Warning |
|
or
|
Info |
|
|
🧪 Development
Run in Development Mode
npm run dev # Uses tsx with watch mode
Build
npm run build # Compiles TypeScript to dist/
Start Production Server
npm start # Runs compiled JavaScript
Testing
npm test # Run tests once
npm run test:watch # Run tests in watch mode
📁 Project Structure
notify_me_mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── config.ts # Environment loading & service detection
│ ├── payload.ts # Discord/Slack payload builders
│ ├── senders.ts # HTTP senders with retry logic
│ ├── logger.ts # Secure logging with redaction
│ ├── types.ts # TypeScript interfaces & Zod schemas
│ └── utils.ts # Helper functions
├── dist/ # Compiled JavaScript
├── .env.example # Environment template
├── package.json # Node.js configuration
├── tsconfig.json # TypeScript configuration
└── README.md # This file
🔧 Environment Variables
Variable | Description | Example |
| Discord webhook URL |
|
| Slack webhook URL |
|
| Custom .env file path |
|
| Custom .env directory |
|
🐛 Troubleshooting
Common Issues
"No webhook URLs configured"
Ensure
.envfile exists with valid webhook URLsCheck environment variable names match exactly
"Discord message exceeds 2000 character limit"
Discord has a 2000 character limit for message content
Use embeds for longer content or split messages
"Invalid JSON in embed_json"
Validate JSON syntax before sending
Use proper escaping for quotes in JSON strings
Connection timeouts
Check network connectivity to Discord/Slack APIs
Verify webhook URLs are correct and active
Debug Mode
For troubleshooting, you can run with verbose logging:
DEBUG=* npm start
🤝 Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/my-featureMake your changes
Build and test:
npm run build && npm testCommit your changes:
git commit -am 'Add some feature'Push to the branch:
git push origin feature/my-featureSubmit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔗 Related Projects
notify_me.sh - The original bash script that inspired this MCP server
Model Context Protocol - Official MCP documentation
Discord Webhooks - Discord webhook documentation
Slack Webhooks - Slack incoming webhook documentation
🙋♂️ Support
Issues: Report bugs and request features on GitHub Issues
Documentation: Check this README and inline code comments
MCP Protocol: Refer to MCP documentation for client setup
Built with ❤️ using TypeScript and the Model Context Protocol
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables sending rich notifications to Discord and/or Slack webhooks with automatic service detection, retry logic, and support for embeds, blocks, and attachments. Provides secure webhook management with comprehensive input validation and rate limiting.
Related MCP Servers
- AsecurityAlicenseAqualityEnables sending messages to webhook endpoints through the MCP protocol, supporting custom content, display names, and avatar URLs.Last updated -4223MIT License
- -securityFlicense-qualityA Message Control Protocol server that integrates with Slack to provide channel management, messaging capabilities, and log monitoring across multiple servers, enabling teams to share logs and receive automated alerts in Slack channels.Last updated -
- -securityFlicense-qualityEnables comprehensive Slack workspace automation and management through the Slack API. Supports messaging, channel management, analytics, file uploads, polls, user management, and advanced features like scheduled messages and bulk operations.Last updated -5,441