Slack Notify

Transform Claude AI workflows into real-time Slack notifications. This MCP server lets you route Claude task updates to multiple Slack channels, with rich formatting and precise channel targeting to keep your team informed without switching apps.

How to use

You run this MCP server locally and connect it to your Claude Desktop client. For each Slack channel you want to receive notifications, you’ll have a dedicated tool that sends messages to that channel. Use the appropriate tool to post messages, optionally with a title and color to emphasize importance.

How to install

Prerequisites: Node.js and npm installed on your system.

# 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. Run the MCP server locally
node index.js

Configuration and usage notes

Create Slack webhooks for each channel you want to notify. Then configure channels in a JSON file to map channel keys to 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"
    }
  }
}

Connecting to Claude Desktop

Add the MCP server to your Claude Desktop configuration so Claude can use the Slack notification tools.

{
  "mcpServers": {
    "slack-notifications": {
      "command": "node",
      "args": ["/Users/yourname/code/workflows/Slack-Notification-MCP/index.js"]
    }
  }
}

Usage examples

After setup, use these tools to send messages to their respective channels. Tools are named to reflect the target channel, for example slack_notify_general, slack_notify_notifications, and slack_notify_alerts.

# Basic message
slack_notify_notifications --message "Task completed successfully!"

# Message with a title
slack_notify_general --title "Build Complete" --message "The deployment finished without errors"

# Colored (formatted) message
slack_notify_alerts --title "Error Detected" --message "API endpoint is returning 500 errors" --color "danger"

Tool parameters

Each tool accepts these parameters. Provide the required fields and optional enhancements to format the Slack message.

--message <text>      # required main content
--title <text>        # optional bold title
--color <value>       # optional: good|warning|danger

Security and maintenance

Keep webhook URLs secure and do not commit them to version control. Use environment isolation for production deployments and rotate tokens if needed.

Troubleshooting

If you encounter issues, verify the MCP command path, ensure Claude Desktop is configured to use the MCP server, and confirm that Slack webhooks are active and reachable.

Development and testing

Run the server in development mode to watch for changes and automatically restart.

npm run dev

Available tools

slack_notify_general

Sends messages to the General Slack channel, with optional title and color to highlight important updates.

slack_notify_notifications

Sends task-related notifications to the Task Notifications channel, suitable for long-running process updates.

slack_notify_alerts

Sends alert messages to the System Alerts channel with a color to indicate severity.