Slack MCP Server

MCP Server for the Slack API, enabling Claude to interact with Slack workspaces.

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by Slack Technologies, Inc. "Slack" is a registered trademark of Slack Technologies, Inc. This is an independent integration built using Slack's public APIs.

Tools

1. slack_list_channels

   • List public or pre-defined channels in the workspace
   • Optional inputs:
     • limit (number, default: 100, max: 200): Maximum number of channels to return
     • cursor (string): Pagination cursor for next page
   • Returns: List of channels with their IDs and information

2. slack_post_message

   • Post a new message to a Slack channel
   • Required inputs:
     • channel_id (string): The ID of the channel to post to
     • text (string): The message text to post
   • Returns: Message posting confirmation and timestamp

3. slack_reply_to_thread

   • Reply to a specific message thread
   • Required inputs:
     • channel_id (string): The channel containing the thread
     • thread_ts (string): Timestamp of the parent message
     • text (string): The reply text
   • Returns: Reply confirmation and timestamp

4. slack_delete_message

   • Delete a specific message in Slack
   • Required inputs:
     • channel_id (string): The channel containing the message
     • timestamp (string): Timestamp of the message to delete
   • Returns: Deletion confirmation

5. slack_add_reaction

   • Add an emoji reaction to a message
   • Required inputs:
     • channel_id (string): The channel containing the message
     • timestamp (string): Message timestamp to react to
     • reaction (string): Emoji name without colons
   • Returns: Reaction confirmation

6. slack_get_channel_history

   • Get recent messages from a channel
   • Required inputs:
     • channel_id (string): The channel ID
   • Optional inputs:
     • limit (number, default: 10): Number of messages to retrieve
   • Returns: List of messages with their content and metadata

7. slack_get_thread_replies

   • Get all replies in a message thread
   • Required inputs:
     • channel_id (string): The channel containing the thread
     • thread_ts (string): Timestamp of the parent message
   • Returns: List of replies with their content and metadata

8. slack_get_users

   • Get list of workspace users with basic profile information
   • Optional inputs:
     • cursor (string): Pagination cursor for next page
     • limit (number, default: 100, max: 200): Maximum users to return
   • Returns: List of users with their basic profiles

9. slack_get_user_profile

   • Get detailed profile information for a specific user
   • Required inputs:
     • user_id (string): The user's ID
   • Returns: Detailed user profile information

Setup

1. Create a Slack App:

   • Visit the Slack Apps page
   • Click "Create New App"
   • Choose "From scratch"
   • Name your app and select your workspace

2. Configure Bot Token Scopes: Navigate to "OAuth & Permissions" and add these scopes:

   • channels:history - View messages and other content in public channels
   • channels:read - View basic channel information
   • chat:write - Send messages as the app
   • reactions:write - Add emoji reactions to messages
   • users:read - View users and their basic information
   • users.profile:read - View detailed profiles about users

3. Install App to Workspace:

   • Click "Install to Workspace" and authorize the app
   • Save the "Bot User OAuth Token" that starts with xoxb-

4. Get your Team ID (starts with a T) by following this guidance

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using Node.js (Recommended for local installation)

First, clone and build the project:

git clone https://github.com/tokamohsen/mcp-slack.git
cd mcp-slack/src/slack
npm install
npm run build

Then add to your claude_desktop_config.json:

{
  "mcpServers": {
    "slack": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-slack/src/slack/dist/index.js"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

Replace /absolute/path/to/mcp-slack with the actual path where you cloned the repository.

Docker

Build the Docker image first:

docker build -t tokamohsen/mcp-slack -f src/slack/Dockerfile .

Then add to your claude_desktop_config.json:

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLACK_BOT_TOKEN",
        "-e",
        "SLACK_TEAM_ID",
        "-e",
        "SLACK_CHANNEL_IDS",
        "tokamohsen/mcp-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

Usage with VS Code

Add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

Using Node.js

First, clone and build the project:

git clone https://github.com/tokamohsen/mcp-slack.git
cd mcp-slack/src/slack
npm install
npm run build

Then add to your VS Code settings:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "node",
        "args": ["/absolute/path/to/Slack-MCP/src/slack/dist/index.js"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Replace /absolute/path/to/mcp-slack with the actual path where you cloned the repository.

Docker

Build the Docker image first:

docker build -t tokamohsen/mcp-slack -f src/slack/Dockerfile .

Then add to your VS Code settings:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "slack-mcp"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

Environment Variables

1. SLACK_BOT_TOKEN: Required. The Bot User OAuth Token starting with xoxb-.
2. SLACK_TEAM_ID: Required. Your Slack workspace ID starting with T.
3. SLACK_CHANNEL_IDS: Optional. Comma-separated list of channel IDs to limit channel access (e.g., "C01234567, C76543210"). If not set, all public channels will be listed.

Troubleshooting

If you encounter permission errors, verify that:

1. All required scopes are added to your Slack app
2. The app is properly installed to your workspace
3. The tokens and workspace ID are correctly copied to your configuration
4. The app has been added to the channels it needs to access

Build

Local Build

cd src/slack
npm install
npm run build

Docker Build

docker build -t tokamohsen/mcp-slack -f src/slack/Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.