Slack MCP Server

Slack MCP Server とは？

Slack MCP Server（korotovsky/slack-mcp-server）は、Claude や Cursor などの MCP クライアントからチャンネル、スレッド、DM を読み取り、メッセージ検索や未読の整理ができるオープンソースの Slack MCP サーバーです。ローカルで動作し、OAuth、Bot、ブラウザセッションのいずれかのトークンを使えます。

MIT ライセンスのコミュニティプロジェクトであり、Slack の公式製品ではありません。メッセージ投稿やリアクション追加などの書き込み操作はデフォルトで無効になっており、明示的に有効化する必要があります。Slack 自身がホストするエンドポイントを使いたい場合は、後述の比較セクションを参照してください。

Slack MCP Server の使い方

npx が使える Node.js（または Docker）と、Slack の認証情報が 1 組必要です。サーバーは以下のいずれか 1 つを受け付けます。複数を設定した場合の優先順位は xoxp > xoxb > xoxc/xoxd です。

• ユーザー OAuth トークン（xoxp-...）：SLACK_MCP_XOXP_TOKEN で指定します。api.slack.com/apps でアプリを作成し、channels:history、channels:read、groups:history、im:history、mpim:history、users:read、search:read、（投稿用の）chat:write などのユーザートークンスコープを追加してインストールし、User OAuth Token をコピーします。
• Bot トークン（xoxb-...）：SLACK_MCP_XOXB_TOKEN で指定します。Bot は招待されたチャンネルしか参照できず、メッセージ検索は使えません。
• ブラウザセッショントークン：SLACK_MCP_XOXC_TOKEN と SLACK_MCP_XOXD_TOKEN で指定します（「ステルスモード」）。xoxc- トークンは Slack Web アプリのローカルストレージから、xoxd- は d という名前の Cookie の値から取得します。アプリのインストールは不要ですが、これらのトークンはセッション全体の権限を持ちます。

Claude Desktop

claude_desktop_config.json にサーバーを追加します。

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

認証方式に応じて、env を SLACK_MCP_XOXB_TOKEN、または SLACK_MCP_XOXC_TOKEN と SLACK_MCP_XOXD_TOKEN に置き換えてください。Claude Desktop では、プロジェクトの GitHub Releases から .dxt 拡張機能をダウンロードし、Settings → Extensions でインストールしてトークン欄を入力する方法もあります。

Claude Code

同じコマンドと環境変数を使います。

claude mcp add slack -e SLACK_MCP_XOXP_TOKEN=xoxp-... -- npx -y slack-mcp-server@latest --transport stdio

Cursor

README には xoxc/xoxd、xoxp、xoxb の各方式に対応した Cursor のワンクリックインストールリンクがあります。インストール後にプレースホルダーのトークンを置き換えてください。上記の JSON を Cursor の MCP 設定に貼り付けることもできます。

Docker

docker run -i --rm -e SLACK_MCP_XOXP_TOKEN ghcr.io/korotovsky/slack-mcp-server:latest --transport stdio

SSE を使う場合は、HTTPS でアクセスできる場所にサーバーを立てて SLACK_MCP_API_KEY で保護し、Claude Desktop からは mcp-remote で Authorization: Bearer ヘッダーを付けて接続します。

Slack MCP Server の主な機能

• 3 種類の認証モード：ユーザー OAuth（xoxp）、Bot（xoxb）、ブラウザセッションの「ステルス」トークン（xoxc/xoxd）
• 時間（1d、7d、30d）またはメッセージ数で賢く制限できるチャンネル・スレッド履歴と、カーソルによるページネーション
• ID だけでなく名前（#general、@username_dm）でチャンネルや DM を指定可能
• チャンネル、ユーザー、日付、スレッドのみといったフィルター付きのワークスペース全体のメッセージ検索
• DM > Slack Connect のパートナーチャンネル > 社内チャンネルの優先順位で未読を整理
• 安全なデフォルト：書き込みツールは有効化しない限り登録されず、チャンネル単位の許可リストにも対応
• Enterprise Slack 向けオプション（SLACK_MCP_USER_AGENT、SLACK_MCP_CUSTOM_TLS）、GovSlack モード（SLACK_MCP_GOVSLACK）、プロキシ対応
• ユーザーとチャンネルのローカルキャッシュ、および slack://<workspace>/channels と slack://<workspace>/users の CSV リソース

Slack MCP Server のツール

• 会話の読み取り：conversations_history と conversations_replies はチャンネルや DM のメッセージ、スレッド全体を取得します。channels_list はパブリック、プライベート、DM、グループ DM のチャンネルを一覧表示します。
• 検索：conversations_search_messages はフィルター付きでメッセージを検索するほか、Slack のメッセージ URL から 1 件を特定できます。users_search は名前、メール、表示名でユーザーを探します。
• 未読：conversations_unreads は未読メッセージを効率よく集め、conversations_mark はチャンネルを既読にします（SLACK_MCP_MARK_TOOL を設定しない限り無効）。
• 書き込み：conversations_add_message、reactions_add、reactions_remove は SLACK_MCP_ADD_MESSAGE_TOOL と SLACK_MCP_REACTION_TOOL で有効化するオプトイン方式です。
• ユーザーグループ：usergroups_list、usergroups_create、usergroups_update、usergroups_users_update、usergroups_me でユーザーグループを管理します（usergroups:read/usergroups:write スコープが必要）。
• 保存済みアイテム：saved_list、saved_update、saved_clear_completed は「Save for Later」を操作するツールで、ブラウザセッショントークンが必要です。

SLACK_MCP_ENABLED_TOOLS でクライアントに見せるツールを絞り込めます。

Slack MCP Server のユースケース

• チャンネルの要約：「#incidents の過去 7 日間の出来事を要約し、未対応のアクションアイテムを挙げて」
• 朝の未読整理：「未読の DM とメンションを重要度順に表示して」
• 決定事項の検索：「Q3 のローンチ日を決めたスレッドを探して、最後のメッセージを引用して」
• 下書きと投稿：「リリースノートを #announcements に投稿して」（投稿はそのチャンネル ID のみに制限）
• メンバー検索：「データチームの Dana を探して、役職と DM チャンネルを表示して」

Slack MCP Server と代替ツールの比較

• Slack 公式 MCP サーバー：Slack は https://mcp.slack.com/mcp で独自のサーバーをホストしています（Streamable HTTP、OAuth）。ドキュメントは docs.slack.dev にあり、Claude.ai、Claude Code、Cursor、Perplexity などのパートナークライアントで利用できます。カスタムクライアントは、社内アプリまたはディレクトリ公開済みの Slack アプリに紐づける必要があります。管理者が承認済みで Slack 管理の連携を求める場合はこちらを選びます。
• アーカイブ済みのリファレンスサーバー：MCP プロジェクトの元の Slack サーバーは modelcontextprotocol/servers-archived に移され、メンテナンスされていません。
• このコミュニティ版 Slack MCP サーバーは、ローカルでの制御、アプリ不要のブラウザトークン認証、未読整理、Enterprise/GovSlack オプション、細かなツール許可リストが必要な場合に向いています。

ほかのチャットプラットフォームについては Discord MCP Server を参照してください。

Slack MCP Server のトラブルシューティング

• 検索が使えない：Bot トークン（xoxb）は search.messages を呼び出せないため、conversations_search_messages は利用できません。xoxp または xoxc/xoxd トークンを使ってください。
• #チャンネル や @ユーザー の名前が解決されない：ユーザーとチャンネルのキャッシュがまだ作成されていません。キャッシュがないと channels_list は動作せず、名前での指定も失敗します。キャッシュの作成を待つか、SLACK_MCP_USERS_CACHE/SLACK_MCP_CHANNELS_CACHE のパスを確認してください。
• Enterprise ワークスペースでブラウザトークンが拒否される：SLACK_MCP_USER_AGENT をトークンを取得したブラウザの User-Agent に設定し、SLACK_MCP_CUSTOM_TLS を有効にします。
• Claude Desktop で DXT 拡張機能が起動しない：ドキュメントでは、Claude Desktop 同梱の Node を無効にしてホストの Node を使うよう案内しています。
• 投稿ツールが表示されない：書き込みツールはデフォルトでは登録されません。SLACK_MCP_ADD_MESSAGE_TOOL を true またはカンマ区切りのチャンネル ID リストに設定してください。ログは tail -n 20 -f ~/Library/Logs/Claude/mcp*.log で確認できます。