# Slack MCP server

> Lets an AI client read channels and threads, post and update messages, reply in threads, react, and upload snippets in Slack.

- Repository: https://github.com/pulsemcp/mcp-servers
- Page: https://hostedmcp.org/servers/pulsemcp/slack
- Official: yes
- Transport: stdio
- Stars: 81
- License: MIT
- Latest version: 0.0.7

## Install

### Claude Code

```sh
claude mcp add --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' slack -- npx -y slack-workspace-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "slack-workspace-mcp-server"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "slack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "slack-workspace-mcp-server"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"slack","type":"stdio","command":"npx","args":["-y","slack-workspace-mcp-server"],"env":{"SLACK_BOT_TOKEN":"<YOUR_SLACK_BOT_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "slack-workspace-mcp-server"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add slack --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' -- npx -y slack-workspace-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.slack]
command = "npx"
args = ["-y", "slack-workspace-mcp-server"]

[mcp_servers.slack.env]
SLACK_BOT_TOKEN = "<YOUR_SLACK_BOT_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' slack npx -- -y slack-workspace-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "slack-workspace-mcp-server"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SLACK_BOT_TOKEN` | yes | yes | Slack Bot User OAuth Token starting with xoxb-. |
| `ENABLED_TOOLGROUPS` | no | no | Comma-separated list of tool groups to enable (readonly, write). |

## Tools (10)

- `slack_get_channels`
- `slack_get_channel`
- `slack_get_thread`
- `slack_post_message`
- `slack_reply_to_thread`
- `slack_update_message`
- `slack_react_to_message`
- `slack_upload_snippet`
- `readonly`
- `write`

## FAQ

### How do I authenticate the Slack MCP server?

It uses a Slack Bot User OAuth Token supplied via the SLACK_BOT_TOKEN environment variable; the token starts with xoxb-.

### Can the Slack MCP server post messages and reply in threads?

Yes, it can post new messages to channels, reply to existing threads, update posted messages, and add emoji reactions.

### How do I make the Slack MCP server read-only?

Set the ENABLED_TOOLGROUPS environment variable to readonly to disable all write operations.

### Can the Slack MCP server upload long content?

Yes, it can upload text content as a file snippet for content that exceeds message limits.

### Which Slack bot scopes does the server require?

It requires scopes such as channels:read, channels:history, groups:read, groups:history, chat:write, reactions:write, and files:write.
