slack-mcp.md

Slack MCP Server

MCP server
from"korotovsky"
1.9k

slack-mcp-server by korotovsky is the most-starred community Slack MCP server. Slack does not maintain it. It reads channel, thread and DM history, searches messages and lists unread messages. Posting is available but switched off until you enable it.

Source and setup verified on 2026-11-03

Communication
Slackmessagingchannelsworkspace

Quick facts

Maintainer
korotovsky (community, not Slack)
Auth
xoxp user token, xoxb bot token, or xoxc/xoxd browser tokens
Transports
stdio, SSE, HTTP
Install
npx, or .dxt extension for Claude Desktop
Posting
Off by default (SLACK_MCP_ADD_MESSAGE_TOOL)

>See it running

Analytics demo from the project README. Source
Posting a message, after enabling the add-message tool. Source

What you can do

  • Fetch channel, thread and DM history by date range or message count
  • Search messages with date, user and content filters
  • List unread messages across channels, DMs first, and mark them read
  • Post messages, only after you enable it, optionally limited to listed channels

Requirements

  • Node.js, for the npx install
  • One Slack token: xoxp, xoxb, or the xoxc + xoxd pair
  • A bot token (xoxb) only sees channels it was invited to and cannot search
setup.md
# 1. Get a token

The repository's docs/01-authentication-setup.md explains each token type.

# 2. Add the server to your client

Paste the config below and replace the token.

# 3. Restart the client

Then ask, for example, for a summary of yesterday's messages in #general.

# Claude Desktop → claude_desktop_config.json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "slack-mcp-server@latest", "--transport", "stdio"],
      "env": {
        "SLACK_MCP_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

Claude Desktop users can instead download slack-mcp-server.dxt from the latest release and drop it on Settings → Extensions.

Always confirm the latest setup instructions with the maintainer before installing.

>Questions

Is this the official Slack MCP server?

No. It is an independent open-source project by korotovsky.

Which token should I use?

A user token (xoxp) works for most tools without extracting browser cookies. A bot token (xoxb) is limited to invited channels and has no search. Some tools, such as unread counts and mark-as-read, work best or only with xoxc/xoxd browser tokens.

How do I let it post messages?

Set SLACK_MCP_ADD_MESSAGE_TOOL to true for all channels, or to a comma-separated list of channel IDs to allow only those.

It fails on Enterprise Slack

Set SLACK_MCP_USER_AGENT to the browser User-Agent you took the tokens from and enable SLACK_MCP_CUSTOM_TLS.