Slack MCP

🚀 Slack MCP

Your entire Slack workspace — available to any AI.

This is a Model Context Protocol server that allows LLMs to fully access Slack. It provides access to messages, channels, files, canvases, lists, search, reactions, and all other Slack features.

193 tools · 35 API families · Every Slack feature

🚀 Quick Start

1. Create a Slack App

1. Go to api.slack.com/apps.
2. Click Create New App > From an app manifest > Select Workspace > Paste the contents of manifest.json.
3. Install the app to your workspace.
4. Copy the User OAuth Token (xoxp-...) from OAuth & Permissions.

2. Add to your AI client

claude mcp add slack -- uvx --from git+https://github.com/karbassi/slack-mcp.git slack-mcp

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
      "env": {
        "SLACK_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "slack": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
        "env": {
          "SLACK_XOXP_TOKEN": "xoxp-..."
        }
      }
    }
  }
}

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/slack-mcp", "slack-mcp"]
    }
  }
}

✨ Features

What Can It Do?

• "Catch me up on #engineering from today"
• "Reply to Sarah's thread saying we'll ship it Monday"
• "Search for anything about the Q3 roadmap"
• "Create a channel called #project-atlas and invite the design team"

Plus a cache_clear utility tool to bust the response cache on demand.

Beyond the Official API

There are 15 undocumented and legacy endpoints, which are the same internal APIs used by Slack's own apps. These require session tokens (xoxc + xoxd).

🔧 Technical Details

Authentication

⚠️ Important Note

The xoxp token covers all 193 official API tools. For undocumented endpoints (unread counts, workspace boot, file editing), you also need xoxc + xoxd. You can grab them from your browser cookies while logged into slack.com.

Caching

Responses are cached automatically to reduce API calls:

• Stable data (users, teams, bots, emoji) — 1 hour TTL
• Dynamic data (channel lists, members, bookmarks) — 5 minute TTL
• Old threads (conversations_replies with ts > 1 hour old) — 1 hour TTL
• Bounded history (conversations_history with old date range) — 1 hour TTL

Use the cache_clear tool to bust the cache when you need fresh data.

📦 Installation

git clone https://github.com/karbassi/slack-mcp.git
cd slack-mcp
uv sync
uv run ruff check .
uv run pytest tests/
uv run pytest tests/ -m integration  # requires tokens in .env

📄 License

MIT