mcp-slack-notifications

Chiuchau-Inc/mcp-slack-notifications

3.1

If you are the rightful owner of mcp-slack-notifications and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Slack Notifications MCP Server integrates Slack notifications into Claude AI workflows, providing alerts for task completions, errors, and user input requirements.

Tools
3
Resources
0
Prompts
0

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

Slack Notification Example MCP Compatible TypeScript

✨ 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 file for details.

🙋‍♂️ Support

🔗 Related Projects

Made with ❤️ for the Claude AI ecosystem