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:
-
Clone the repository:
git clone https://github.com/Chisanan232/slack-mcp-server.git
cd slack-mcp-server -
Install in development mode:
- pip
- poetry
- uv
pip install -e .poetry installuv pip install .
Docker Installation
You can also run Slack MCP Server using Docker:
-
Pull the Docker image:
docker pull chisanan232/slack-mcp-server:latest -
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:
- pip
- poetry
- uv
slack-mcp-server --version
poetry run slack-mcp-server --version
uv run slack-mcp-server --version
You should see the current version of the Slack MCP Server displayed.
- [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]"