Skip to main content
Version: Next

Installation

This guide provides step-by-step instructions for installing the Slack MCP Server on your system.

Prerequisites​

Before installation, make sure you've met all the requirements.

Install Using pip​

Slack MCP Server can be installed directly using pip, which is included with Python:

# Minimal base (protocol only; no MCP runtime or webhook server)
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]"

Install Using poetry​

For better dependency management and project isolation, we recommend installing Slack MCP Server using poetry:

# Minimal base
poetry add slack-mcp

# MCP server feature set
poetry add slack-mcp -E mcp

# Webhook server feature set
poetry add slack-mcp -E webhook

# Everything
poetry add slack-mcp -E all

Install Using uv​

For faster installation with advanced dependency resolution, another recommended approach is using uv:

# Minimal base
uv add slack-mcp

# MCP server feature set
uv add "slack-mcp[mcp]"

# Webhook server feature set
uv add "slack-mcp[webhook]"

# Everything
uv add "slack-mcp[all]"

Install from Source​

For the latest development version or to contribute to the project:

  1. Clone the repository:

    git clone https://github.com/Chisanan232/slack-mcp-server.git
    cd slack-mcp-server

  2. Install in development mode:

    pip install -e .

Docker Installation​

You can also run Slack MCP Server using Docker:

  1. Pull the Docker image:

    docker pull chisanan232/slack-mcp-server:latest

  2. Or build the image yourself:

    git clone https://github.com/Chisanan232/slack-mcp-server.git
    cd slack-mcp-server
    docker build -t slack-mcp-server .

Verifying Installation​

To verify that the installation was successful, run:

slack-mcp-server --version

You should see the current version of the Slack MCP Server displayed.

Installation Extras
  • [mcp]: Installs the MCP server feature set (SSE/Streamable transports; not the integrated webhook mode). Recommended if you only need the MCP server.
  • [webhook]: Installs FastAPI/Uvicorn and related parts for Slack webhook handling (not the integrated mode). Recommended if you only need the webhook server.
  • [all]: Installs everything in this project.
  • Base (no extra): Minimal install with only the base protocol rules of this project.

Examples:

# MCP server only
pip install "slack-mcp[mcp]"

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

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