🚀 Slack Notifications MCP Server

A powerful Model Context Protocol (MCP) server that brings Slack notifications to Claude AI workflows. Perfect for getting notified when long-running tasks complete, errors occur, or when user input is needed.

✨ Features

• 📱 Rich Slack Messages: Formatted messages with attachments, colors, and fields

• 🎯 Task Completion Notifications: Specialized notifications for development workflows

• 🔧 Webhook Configuration: Easy setup with Slack webhook URLs

• 🌈 Color-Coded Status: Visual indicators for success, error, warning, and info

• 🎨 Customizable: Channel selection, bot username, emojis, and priority levels

• 🚀 Zero Config: Works with environment variables or runtime configuration

🛠️ Tools

send_slack_notification

Send a customizable Slack notification with full formatting options.

Parameters:

• title (required): The notification title

• message (required): The notification message

• webhook_url (optional): Slack webhook URL (if not configured globally)

• channel (optional): Target channel (e.g., #general, @username)

• username (optional): Bot username (default: "Claude Code")

• icon_emoji (optional): Bot emoji (default: ":robot_face:")

• color (optional): Message color (good, warning, danger, info, or hex)

• priority (optional): Priority level (low, normal, high, urgent)

slack_task_completion_notification

Send a specialized notification for task completion with intelligent formatting.

Parameters:

• status (required): success, error, warning, or info

• taskType (optional): Type of task (e.g., "Build", "Deploy", "Test")

• duration (optional): How long the task took

• summary (optional): Brief summary of accomplishment

• url (optional): Related URL (e.g., localhost development server)

• webhook_url (optional): Slack webhook URL (if not configured globally)

• channel (optional): Target channel

configure_slack_webhook

Configure global Slack webhook settings for the session.

Parameters:

• webhook_url (required): Your Slack webhook URL

• default_channel (optional): Default channel for notifications

🚀 Quick Start

1. Create Slack Webhook

1. Go to Slack API: Visit api.slack.com

2. Create New App: Click "Create New App" > "From scratch"

3. Configure Incoming Webhooks:

   • Go to "Incoming Webhooks" in the sidebar

   • Activate incoming webhooks

   • Click "Add New Webhook to Workspace"

   • Choose your channel and authorize

   • Copy the webhook URL (starts with https://hooks.slack.com/services/...)

2. Installation

1. Clone this repository: ```bash git clone https://github.com/chiuchau-cyril/mcp-slack-notifications.git cd mcp-slack-notifications ```

2. Install dependencies: ```bash npm install ```

3. Build the project: ```bash npm run build ```

3. Configuration

For Claude Code

Add to your Claude Code MCP configuration:

```json { "mcpServers": { "slack-notifications": { "command": "node", "args": ["/Users/cyril/Documents/git/mcp-servers/slack-notifications/dist/index.js"], "env": { "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL" } } } } ```

For Claude App

Add to your Claude App MCP settings:

```json { "slack-notifications": { "command": "node", "args": ["/Users/cyril/Documents/git/mcp-servers/slack-notifications/dist/index.js"], "env": { "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL" } } } ```

4. Testing

Run the test suite to verify everything works:

```bash node test-slack-notifications.js ```

📱 Usage Examples

Basic Notification

```javascript // Simple notification { "title": "🎉 Task Complete", "message": "Your build finished successfully!", "channel": "#development", "color": "good" } ```

Development Workflow

```javascript // Task completion with details { "status": "success", "taskType": "React Build", "duration": "2 minutes", "summary": "Compiled 45 components successfully", "url": "http://localhost:3000", "channel": "#dev-notifications" } ```

Error Notification

```javascript // Error with high priority { "title": "❌ Build Failed", "message": "TypeScript compilation errors detected", "color": "danger", "priority": "urgent", "channel": "#alerts" } ```

Configuration

```javascript // Set up webhook for the session { "webhook_url": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL", "default_channel": "#claude-notifications" } ```

🎯 Smart Notification Logic

This MCP server implements the same intelligent notification timing as the macOS version:

⚠️ Immediate Notifications (User Action Required)

• Commands waiting for confirmation (Do you want to proceed?)

• Password prompts

• Any user input required

• Priority: urgent with red color

✅ Completion Notifications (Task Finished)

• Build processes completed

• Tests finished running

• Deployments completed

• Color: Green (success) / Red (error) / Orange (warning)

🔇 No Notifications

• Simple queries (ls, pwd)

• Commands still running normally

• Quick operations (< 30 seconds)

🎨 Slack Message Features

Color Coding

• Green (good): Success, completed tasks

• Orange (warning): Warnings, partial failures

• Red (danger): Errors, critical issues

• Blue (info): Information, status updates

• Custom: Any hex color code (e.g., #FF5733)

Priority Levels

• Low: #cccccc (gray)

• Normal: #0099cc (blue)

• High: #ff9500 (orange)

• Urgent: #ff0000 (red)

Rich Formatting

• Attachments: Structured message layout

• Fields: Key-value pairs with short/long display

• Timestamps: Automatic message timing

• Footer: "Claude Code" branding

🛡️ Requirements

• Node.js 18+

• Slack workspace with webhook permissions

• Internet connection for webhook delivery

🧪 Environment Variables

Set these for easier configuration:

```bash export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL" export SLACK_DEFAULT_CHANNEL="#claude-notifications" ```

📖 Claude Rules Integration

For automatic notification behavior, add these rules to your Claude configuration:

```markdown

Automatically notify on task completion via Slack

When a task takes longer than 2 minutes or requires user input, send a Slack notification using the appropriate tool.

Notification timing:

• User input needed → Immediate notification with urgent priority

• Task completed → Result notification with appropriate status

• Errors occurred → Error notification with danger color ```

🔒 Security Notes

• Webhook URLs contain secrets - keep them private

• Don't commit webhook URLs to version control

• Use environment variables for production deployments

• Limit webhook permissions to necessary channels only

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

MIT License - see LICENSE file for details.

🙋‍♂️ Support

• 🐛 Issues: GitHub Issues

• 💬 Discussions: GitHub Discussions

• 📧 Email: Contact for enterprise support

🔗 Related Projects

• macOS Notifications MCP Server - Native macOS notifications

• Model Context Protocol - Official MCP documentation

Made with ❤️ for the Claude AI ecosystem