Slack Notification MCP Server
by Zavdielx89
README.md
# 🚀 Slack Notification MCP Server
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
[](https://modelcontextprotocol.io/)
[](https://github.com/Zavdielx89/slack-notification-mcp/stargazers)
[](https://buymeacoffee.com/zavdielx)
> **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
```bash
# 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
```bash
cd ~/code/workflows/Slack-Notification-MCP
npm install
```
### 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:
```bash
cp config.example.json config.json
```
Edit `config.json` with your actual Slack webhook URLs:
```json
{
"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):
```json
{
"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_general`
- `slack_notify_notifications`
- `slack_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
```bash
npm run dev
```
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:
```bash
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.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](https://github.com/Zavdielx89/slack-notification-mcp/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:
[](https://buymeacoffee.com/zavdielx)
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](https://modelcontextprotocol.io/) - Learn more about MCP
- [Claude Desktop](https://claude.ai/desktop) - Official Claude desktop application
- [MCP Servers](https://github.com/modelcontextprotocol/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!
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues