🚀 Slack Notification MCP Server
Transform your Claude AI workflows with instant Slack notifications!
A powerful Model Context Protocol (MCP) server that seamlessly connects Claude AI with Slack, enabling real-time notifications for task completions, alerts, and workflow automation. Never miss important updates from your AI assistant again!
✨ Why This MCP Server?
- 🤖 Claude Integration: Built specifically for Claude AI via the Model Context Protocol
- ⚡ Instant Notifications: Get real-time updates when Claude completes tasks
- 🎯 Multi-Channel Support: Send targeted messages to different Slack channels
- 🎨 Rich Formatting: Support for titles, colors, and message styling
- 🔧 Zero Config Hassle: Simple JSON configuration gets you running in minutes
- 🚀 Lightweight: Fast Node.js implementation with minimal dependencies
🛠️ Features
- 🚀 Dynamic tool creation based on your configured Slack channels
- 📱 Support for rich message formatting (titles, colors)
- ⚡ Fast and lightweight Node.js implementation
- 🔧 Easy configuration via JSON file
- 🎯 Separate tools for each channel for precise control
🎯 Perfect For
- AI Workflow Automation: Get notified when Claude finishes long-running tasks
- Development Teams: Automate deployment notifications and error alerts
- Data Analysis: Receive updates when data processing completes
- Content Creation: Get alerts when Claude finishes writing or research tasks
- System Monitoring: Send formatted alerts for system status updates
- Project Management: Automate status updates to project channels
🚀 Quick Start
# 1. Clone and install
git clone https://github.com/Zavdielx89/slack-notification-mcp.git
cd slack-notification-mcp
npm install
# 2. Configure your Slack webhooks
cp config.example.json config.json
# Edit config.json with your webhook URLs
# 3. Add to your Claude Desktop config
# See detailed setup instructions below
📋 Setup
1. Install Dependencies
cd ~/code/workflows/Slack-Notification-MCP
npm install
2. Create Slack Webhooks
For each Slack channel you want to send notifications to:
- Go to your Slack workspace
- Navigate to Apps > Manage > Custom Integrations > Incoming Webhooks
- Or visit:
https://[your-workspace].slack.com/apps/manage/custom-integrations - Click Add to Slack
- Choose the channel you want to send notifications to
- Copy the Webhook URL
3. Configure Channels
Create a config.json file in the project directory:
cp config.example.json config.json
Edit config.json with your actual Slack webhook URLs:
{
"channels": {
"general": {
"name": "General",
"webhook_url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
},
"notifications": {
"name": "Task Notifications",
"webhook_url": "https://hooks.slack.com/services/T11111111/B11111111/YYYYYYYYYYYYYYYYYYYYYYYY"
},
"alerts": {
"name": "System Alerts",
"webhook_url": "https://hooks.slack.com/services/T22222222/B22222222/ZZZZZZZZZZZZZZZZZZZZZZZZ"
}
}
}
4. Add to MCP Settings
Add this server to your MCP client configuration (e.g., Claude Desktop):
{
"mcpServers": {
"slack-notifications": {
"command": "node",
"args": ["/Users/zavdielx/code/workflows/Slack-Notification-MCP/index.js"]
}
}
}
5. Restart Claude Desktop
Restart your Claude Desktop application to load the new MCP server.
Usage
Once configured, you'll have access to tools for each channel you configured. For example, if you configured channels named "general", "notifications", and "alerts", you'll see these tools:
slack_notify_generalslack_notify_notificationsslack_notify_alerts
Basic Message
Use the slack_notify_notifications tool to send a message "Task completed successfully!"
Message with Title
Send a notification to the general channel with title "Build Complete" and message "The deployment finished without errors"
Colored Message
Send an alert to the alerts channel with title "Error Detected", message "API endpoint is returning 500 errors", and color "danger"
Tool Parameters
Each slack_notify_* tool accepts these parameters:
- message (required): The main message content
- title (optional): A bold title that appears before the message
- color (optional): Color for the message sidebar
"good"- Green (success)"warning"- Yellow (warning)"danger"- Red (error)
Example Workflows
Task Completion Notifications
After completing a long analysis, send a message to notifications channel: "Data analysis complete. Found 15 anomalies in the dataset. Report ready for review."
Error Alerts
If an error occurs, send a danger-colored alert to the alerts channel with title "Processing Error" and message "Failed to process user upload: invalid file format"
Status Updates
Send a good-colored message to general channel with title "System Update" and message "All services are running normally after the maintenance window"
Development
Running in Development Mode
npm run dev
This will start the server with file watching for automatic restarts.
Adding New Channels
- Create a new Slack webhook for the channel
- Add the channel configuration to
config.json - Restart the MCP server
- The new
slack_notify_[channel_id]tool will be automatically available
Testing
You can test the server directly:
npm start
The server will run and wait for MCP protocol messages on stdin/stdout.
Troubleshooting
"Config file not found" Error
Make sure you've created config.json in the project directory with valid Slack webhook URLs.
"Failed to send Slack message" Error
- Verify your webhook URLs are correct
- Check that the Slack webhooks are still active
- Ensure the channels still exist in your Slack workspace
Tools Not Appearing in Claude
- Verify the MCP server path in your Claude configuration
- Restart Claude Desktop after making configuration changes
- Check that Node.js is installed and accessible
Security Notes
- Keep your
config.jsonfile secure and don't commit webhook URLs to version control - Webhook URLs provide direct access to post in your Slack channels
- Consider using environment variables for webhook URLs in production environments
🤝 Contributing
Contributions are welcome! Feel free to:
- 🐛 Report bugs or request features via GitHub Issues
- 🔀 Submit pull requests for improvements
- ⭐ Star the repository if you find it useful
- 📢 Share it with others who might benefit
☕ Support This Project
If this MCP server saves you time or enhances your Claude AI workflows, consider supporting its development:
Your support helps me:
- 🚀 Add new features and improvements
- 🐛 Fix bugs and provide support
- 📚 Create better documentation
- 🎯 Build more useful MCP servers for the community
🔗 Related Projects
- Model Context Protocol - Learn more about MCP
- Claude Desktop - Official Claude desktop application
- MCP Servers - Collection of official MCP servers
📈 Stats
Made with ❤️ for the Claude AI community
If this project helps you stay connected with your AI workflows, consider giving it a ⭐!
License
MIT License - feel free to use and modify as needed!