🚀 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

📋 Setup

1. Install Dependencies

2. Create Slack Webhooks

For each Slack channel you want to send notifications to:

1. Go to your Slack workspace

2. Navigate to Apps > Manage > Custom Integrations > Incoming Webhooks

3. Or visit: https://[your-workspace].slack.com/apps/manage/custom-integrations

4. Click Add to Slack

5. Choose the channel you want to send notifications to

6. Copy the Webhook URL

3. Configure Channels

Create a config.json file in the project directory:

Edit config.json with your actual Slack webhook URLs:

4. Add to MCP Settings

Add this server to your MCP client configuration (e.g., Claude Desktop):

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_general

• slack_notify_notifications

• slack_notify_alerts

Basic Message

Message with Title

Colored Message

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

Error Alerts

Status Updates

Development

Running in Development Mode

This will start the server with file watching for automatic restarts.

Adding New Channels

1. Create a new Slack webhook for the channel

2. Add the channel configuration to config.json

3. Restart the MCP server

4. The new slack_notify_[channel_id] tool will be automatically available

Testing

You can test the server directly:

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.json file 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!