Slack MCP reference server (archived)

Archived reference implementation; no longer maintained. Post notifications, query channel discussions, and dispatch task alert threads.

Local (stdio)CredentialArchived upstream

Archived upstream. This server is no longer maintained by its authors and receives no fixes or security updates. The configuration below is kept for existing users; review the upstream notice before installing it.

Set up Slack

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

claude mcp add slack --env SLACK_BOT_TOKEN="$SLACK_BOT_TOKEN" --env SLACK_TEAM_ID="$SLACK_TEAM_ID" -- npx -y @modelcontextprotocol/server-slack

Cursor

Merge into ~/.cursor/mcp.json

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "REPLACE_WITH_BOT_TOKEN",
        "SLACK_TEAM_ID": "REPLACE_WITH_TEAM_ID"
      }
    }
  }
}

Codex

Run in your terminal.

codex mcp add slack --env SLACK_BOT_TOKEN="$SLACK_BOT_TOKEN" --env SLACK_TEAM_ID="$SLACK_TEAM_ID" -- npx -y @modelcontextprotocol/server-slack

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "REPLACE_WITH_BOT_TOKEN",
        "SLACK_TEAM_ID": "REPLACE_WITH_TEAM_ID"
      }
    }
  }
}

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "slack": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "enabled": true,
      "environment": {
        "SLACK_BOT_TOKEN": "REPLACE_WITH_BOT_TOKEN",
        "SLACK_TEAM_ID": "REPLACE_WITH_TEAM_ID"
      }
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "slack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "${input:SLACK_BOT_TOKEN}",
        "SLACK_TEAM_ID": "${input:SLACK_TEAM_ID}"
      }
    }
  },
  "inputs": [
    {
      "id": "SLACK_BOT_TOKEN",
      "type": "promptString",
      "description": "SLACK_BOT_TOKEN",
      "password": true
    },
    {
      "id": "SLACK_TEAM_ID",
      "type": "promptString",
      "description": "SLACK_TEAM_ID",
      "password": false
    }
  ]
}

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, the Cursor JSON goes in claude_desktop_config.json. This is a local server that runs on your machine; see remote vs local servers and authentication and security basics.

Overview

The Slack server was a Model Context Protocol reference implementation, published as @modelcontextprotocol/server-slack. It now sits in the servers-archived repository, which states that the archived servers are no longer maintained, get no security updates, and should be used at your own risk.

It let an agent act in a Slack workspace through a bot. Its tools were slack_list_channels, slack_post_message, slack_reply_to_thread, slack_add_reaction, slack_get_channel_history, slack_get_thread_replies, slack_get_users and slack_get_user_profile. That covered posting notifications from a coding session, summarising a channel's recent discussion, or replying in a thread when a task finished.

Setup caveats: you create your own Slack app, add bot token scopes (channels:history, channels:read, chat:write, reactions:write, users:read and users.profile:read), install it to your workspace, then provide the bot token starting with xoxb- as SLACK_BOT_TOKEN and your workspace ID starting with T as SLACK_TEAM_ID. The optional SLACK_CHANNEL_IDS limits which channels the server can see; otherwise it works with all public channels. Messages read from Slack become model context, and posts go out under your bot's name, so scope the app narrowly. Since it is unmaintained, check Slack's and the MCP project's current options before adopting it. This page stays for existing users.

Example tools

  • slack_post_message
  • slack_get_channel_history
  • slack_list_channels

Tool names are upstream examples. The server's live tool list can differ.

Browse Productivity servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.