Slack Notification

Send notifications to Slack channels using webhook URLs.

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!

- 🤖 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

- 🚀 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

- 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

# 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

cd ~/code/workflows/Slack-Notification-MCP npm install

For each Slack channel you want to send notifications to:
- Go to your Slack workspace
- Navigate toApps>Manage>Custom Integrations>Incoming Webhooks
- Or visit:https://[your-workspace].slack.com/apps/manage/custom-integrations
- ClickAdd to Slack
- Choose the channel you want to send notifications to
- Copy theWebhook URL

Create aconfig.jsonfile in the project directory:

Editconfig.jsonwith 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" } } }

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"] } } }

Restart your Claude Desktop application to load the new MCP server.

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_general
- slack_notify_notifications
- slack_notify_alerts

Use the slack_notify_notifications tool to send a message "Task completed successfully!"

Send a notification to the general channel with title "Build Complete" and message "The deployment finished without errors"

Send an alert to the alerts channel with title "Error Detected", message "API endpoint is returning 500 errors", and color "danger"

Eachslack_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)

After completing a long analysis, send a message to notifications channel: "Data analysis complete. Found 15 anomalies in the dataset. Report ready for review."

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"

Send a good-colored message to general channel with title "System Update" and message "All services are running normally after the maintenance window"

This will start the server with file watching for automatic restarts.
- Create a new Slack webhook for the channel
- Add the channel configuration toconfig.json
- Restart the MCP server
- The newslack_notify_[channel_id]tool will be automatically available

The server will run and wait for MCP protocol messages on stdin/stdout.

Make sure you've createdconfig.jsonin 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

- Verify the MCP server path in your Claude configuration
- Restart Claude Desktop after making configuration changes
- Check that Node.js is installed and accessible

- Keep yourconfig.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

Contributions are welcome! Feel free to:

- 🐛 Report bugs or request features viaGitHub Issues
- 🔀 Submit pull requests for improvements
- ⭐ Star the repository if you find it useful
- 📢 Share it with others who might benefit

- Model Context Protocol- Learn more about MCP
- Claude Desktop- Official Claude desktop application
- MCP Servers- Collection of official MCP servers

A bridge server connecting Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients.