Slack

You can deploy and run a Slack MCP Server that lets LLMs interact with Slack workspaces using OAuth 2.0 authentication. It provides secure token handling, easy client integration, and straightforward deployment options for local and cloud environments.

How to use

Use the MCP server to connect a client, such as a VSCode MCP extension or Claude Desktop, to Slack and perform actions like listing channels or posting messages. The server handles OAuth flow automatically on first use and caches tokens for subsequent requests. You can access the MCP endpoint at the base URL plus the /mcp path and authorize via the Slack OAuth flow when required.

How to install

Prerequisites you need before starting are Python 3.11 or newer and uv as the Python package manager.

Step 1. Slack App configuration is required to obtain OAuth credentials. Create a Slack App, add the necessary OAuth scopes, and set redirect URLs for local and production environments. Then copy the Client ID and Client Secret.

Step 2. Install the MCP server locally by cloning the project and installing dependencies using uv.

# Clone the repository
git clone https://github.com/miyatsuki/study-slack-remote-mcp.git
cd study-slack-remote-mcp

# Install dependencies using uv
uv sync

Configuration and running

Create a configuration file with your Slack OAuth credentials and optional service base URL for production deployments.

# Required: Slack OAuth credentials
SLACK_CLIENT_ID=your_client_id
SLACK_CLIENT_SECRET=your_client_secret

# Optional: Service base URL (for production deployments)
# SERVICE_BASE_URL=https://your-apprunner-url.awsapprunner.com

Run the server locally

Start the MCP server in the foreground or in the background to keep it running while you test.

# Start the server
uv run python server.py

# Or run in background
nohup uv run python server.py > server.log 2>&1 &

Configuration for Claude Desktop (example)

If you use Claude Desktop, add a Slack MCP server entry with the following configuration to your Claude Desktop settings.

{
  "mcpServers": {
    "slack": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/slack-mcp-server",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

Available tools

list_channels

Retrieve a list of Slack channels available in the connected workspace.

post_message

Post a message to a specified Slack channel using its channel ID.

get_auth_status

Check the current authentication state and session information for the Slack OAuth flow.