MCP 服务器

Slack Notification MCP Server

Enables Claude AI to send real-time notifications to Slack channels with support for rich formatting, multiple channels, and customizable message styling for workflow automation and task completion alerts.

README

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

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