Slack MCP Server

Overview

🦾 A strong MCP (Model Context Protocol) server for Slack integration, providing standardized access to Slack's API features through both MCP tools and webhook processing.

Key Features:

• 🤖 MCP Server: Provides 6 essential Slack tools for AI assistants and clients

• 🪝 Webhook Server: Processes real-time Slack events with secure verification

• 🔗 Integrated Mode: Combined MCP + webhook server for complete Slack platform integration

• 🚀 Multiple Transports: Supports stdio, SSE, HTTP streaming, and Socket Mode protocols

• 📦 Easy Deployment: Docker, Kubernetes, and cloud platform ready

• 🔌 Socket Mode: WebSocket-based transport for environments without public HTTP endpoints

Use Cases:

• Building AI assistants with Slack integration

• Creating custom automation tools for Slack workflows

• Developing real-time Slack applications with event processing

• Integrating Slack with other tools and platforms

Related MCP server: Slack MCP Server

Python versions support

slack-mcp-server supports Python 3.12+ for optimal performance and modern language features.

Quickly Start

Installation

Choose your preferred installation method:

Using pip

# Minimal base (protocol only)
pip install slack-mcp

# MCP server feature set
pip install "slack-mcp[mcp]"

# Webhook server feature set
pip install "slack-mcp[webhook]"

# Everything
pip install "slack-mcp[all]"

Using uv (recommended)

# Minimal base
uv add slack-mcp

# MCP server / Webhook / All
uv add "slack-mcp[mcp]"
uv add "slack-mcp[webhook]"
uv add "slack-mcp[all]"

Using poetry

# Minimal base
poetry add slack-mcp

# MCP server / Webhook / All
poetry add slack-mcp -E mcp
poetry add slack-mcp -E webhook
poetry add slack-mcp -E all

Note: Installation extras

• [mcp]: Installs the MCP server feature set (SSE/Streamable transports; not the integrated webhook mode)

• [webhook]: Installs FastAPI/Uvicorn and related parts for Slack webhook handling (not the integrated mode)

• [all]: Installs everything in this project

• Base (no extra): Minimal install with only the base protocol rules of this project

Basic Usage

1. Set Up Environment Variables

For Production/Development:

# Copy the production environment template
cp .env.example .env

# Edit with your actual values
# Required: Slack bot token
export SLACK_BOT_TOKEN="xoxb-your-bot-token-here"

# Optional: For webhook server
export SLACK_SIGNING_SECRET="your-signing-secret"

# Optional: For Socket Mode transport
export SLACK_APP_TOKEN="xapp-your-app-token-here"

For Testing:

# Copy the test environment template
cp test/.env.test.example test/.env.test

# Edit with your test values (used by pytest)
# Required: E2E test token
export E2E_TEST_API_TOKEN="xoxb-your-test-token"

2. Start MCP Server (Standalone)

# Start with stdio transport (default)
slack-mcp-server

# Start with SSE transport for web clients
slack-mcp-server --transport sse --host 0.0.0.0 --port 3001

# Start with Socket Mode transport for WebSocket connections
slack-mcp-server --transport socket-mode --app-token xapp-your-app-token

3. Start Webhook Server (Standalone)

# Start standalone webhook server
slack-webhook-server --host 0.0.0.0 --port 3000

4. Start Integrated Server (MCP + Webhook)

# Combined server with both MCP and webhook functionality
slack-mcp-server --integrated --transport sse --port 8000

Available MCP Tools

Docker Quick Start

# Pull and run with environment variables
docker run -p 3000:3000 \
  -e SLACK_BOT_TOKEN="xoxb-your-token" \
  -e SLACK_SIGNING_SECRET="your-secret" \
  chisanan232/slack-mcp-server:latest

Socket Mode Transport

Socket Mode is a WebSocket-based transport that allows the Slack MCP server to communicate with Slack without requiring public HTTP endpoints. This is particularly useful for:

• Applications behind firewalls or NAT

• Environments without public internet access

• Enhanced security through WebSocket tunneling

• Development and testing without public infrastructure

Setup Requirements:

1. Enable Socket Mode in your Slack App:

   • Go to https://api.slack.com/apps → Your App → Basic Information

   • Enable Socket Mode

   • Create an App-Level Token with connections:write scope

2. Configure Environment Variables:

# Required for Socket Mode
export SLACK_BOT_TOKEN="xoxb-your-bot-token-here"
export SLACK_APP_TOKEN="xapp-your-app-token-here"

Usage Examples:

# Start with Socket Mode transport
slack-mcp-server --transport socket-mode --app-token xapp-your-app-token

# Socket Mode with app token from environment variable
export SLACK_APP_TOKEN="xapp-your-app-token"
slack-mcp-server --transport socket-mode

Important Notes:

• Socket Mode is a standalone transport and cannot be used with integrated mode

• The app token must start with xapp- prefix

• Socket Mode uses WebSocket connections directly to Slack's servers

• No public HTTP endpoints or webhooks are required

• Automatic reconnection with exponential backoff is built-in

Documentation

Comprehensive documentation is available at https://chisanan232.github.io/slack-mcp-server/

Documentation Sections

• 📖 User Guide - Installation, configuration, and usage

• 🛠️ Developer Guide - Contributing, architecture, and development workflow

• 🏗️ API Reference - Complete CLI and configuration reference

• 🚀 Deployment Guide - Production deployment patterns

Quick Links

• Requirements

• Installation Guide

• Server Modes

• Environment Configuration

• CI/CD Workflows

Coding style and following rules

slack-mcp-server follows coding styles black and PyLint to control code quality, with additional tools for comprehensive code analysis.

Code Quality Tools

• Black: Consistent code formatting

• PyLint: Code analysis and style checking

• MyPy: Static type checking

• isort: Import sorting and organization

• Pre-commit: Automated code quality checks

Development Workflow

# Install development dependencies
uv sync --dev

# Run code quality checks
uv run pre-commit run --all-files

# Run tests
uv run pytest

Downloading state

Current download statistics for slack-mcp package:

Container Downloads

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

1. Report Issues - Found a bug? Let us know!

2. Request Features - Have ideas? We'd love to hear them!

3. Join Discussions - Connect with the community

4. Development Setup - Start contributing code

Extend with Custom Queue Backend Plugins

Want to add support for additional message queue systems? Create custom queue backend plugins using our template:

Slack MCP Server Backend MQ Template - Quick-start template for developing queue backend plugins

• Complete project structure with best practices

• Pre-configured CI/CD workflows

• Comprehensive documentation

📚 Documentation: https://chisanan232.github.io/Slack-MCP-Server-Backend-MQ-Template/

License

MIT License