---
title: "Slack MCP Server Setup Guide and Schema"
slug: "slack"
category: "communication"
package: "@modelcontextprotocol/server-slack"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/slack"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Slack MCP Server

> Read channels, post messages, search threads, and manage Slack workspaces.

## Overview
Integrate AI agents with Slack workspaces. Read channel history, post messages, reply in threads, search for messages, and list channels to enable AI-powered team communication and automation.

## Quick Install
```bash
npx -y @modelcontextprotocol/server-slack
```

## Environment Variables

| Variable | Description | Required |
| :--- | :--- | :--- |
| `SLACK_BOT_TOKEN` | Slack Bot User OAuth Token | **Yes** |
| `SLACK_TEAM_ID` | Slack Workspace Team ID | **Yes** |

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxxxxxxx",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxxxxxxx",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.slack]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-slack"]

[mcp_servers.slack.env]
SLACK_BOT_TOKEN = "xoxb-xxxxxxxx"
SLACK_TEAM_ID = "T01234567"
```

## Available Tools (5)

- `list_channels`
- `post_message`
- `reply_to_thread`
- `search_messages`
- `get_channel_history`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/slack
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/modelcontextprotocol/servers/tree/main/src/slack
- Setup Tutorial Guide: https://mcp-codex.com/articles/slack-mcp-server-setup