🚀 Slack MCP
あなたのSlackワークスペース全体を、あらゆるAIに利用可能にします。
Model Context Protocolサーバーで、大規模言語モデル(LLM)にSlackへの完全なアクセスを提供します。
メッセージ、チャンネル、ファイル、キャンバス、リスト、検索、リアクションなど、すべての機能が利用可能です。
193のツール · 35のAPIファミリー · すべてのSlack機能
🚀 クイックスタート
1. Slackアプリを作成する
- api.slack.com/appsにアクセスし、Create New App > From a manifestを選択します。
- の内容を貼り付けます。
- ワークスペースにインストールします。
- OAuth & PermissionsからUser OAuth Token (
xoxp-...)をコピーします。
2. AIクライアントに追加する
Claude Code
claude mcp add slack -- uvx --from git+https://github.com/karbassi/slack-mcp.git slack-mcp
その後、シェル環境でSLACK_XOXP_TOKENを設定します。
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonに以下を追加します。
{
"mcpServers": {
"slack": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
"env": {
"SLACK_XOXP_TOKEN": "xoxp-..."
}
}
}
}
Cursor
~/.cursor/mcp.jsonに以下を追加します。
{
"mcpServers": {
"slack": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
"env": {
"SLACK_XOXP_TOKEN": "xoxp-..."
}
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.jsonに以下を追加します。
{
"mcpServers": {
"slack": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/karbassi/slack-mcp.git", "slack-mcp"],
"env": {
"SLACK_XOXP_TOKEN": "xoxp-..."
}
}
}
}
VS Code / GitHub Copilot
VS Codeのsettings.jsonに以下を追加します。
{
"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"]
}
}
}
✨ 主な機能
"今日の#engineeringの内容を教えて"
"Sarahのスレッドに、月曜日に出荷すると返信する"
"Q3ロードマップに関するすべての情報を検索する"
"#project-atlasというチャンネルを作成し、デザインチームを招待する"
| ドメイン |
ツール数 |
ハイライト |
| 会話 |
28 |
履歴、スレッド、返信、作成、アーカイブ、招待、既読マーク |
| ファイル |
16 |
アップロード、共有、編集、一覧表示、リモートファイル |
| チャット |
14 |
送信、返信、スケジュール、更新、削除、一時的なメッセージ |
| ユーザー |
12 |
プロフィール、状態、検索、一覧表示 |
| リスト |
12 |
作成、項目の編集、アクセス管理 |
| レガシー |
11 |
スラッシュコマンド、ファイル編集、ボット一覧 |
| チーム |
9 |
情報、設定、アクセスログ、請求 |
| アプリ |
8 |
マニフェスト、接続、認可 |
| ユーザーグループ |
7 |
作成、更新、メンバー管理 |
| ワークフロー |
7 |
おすすめのワークフロー、ステップの完了 |
| キャンバス |
6 |
作成、編集、セクション、アクセス制御 |
| 通話 |
6 |
開始、終了、参加者管理 |
| + 23以上 |
|
DND、リマインダー、ブックマーク、リアクション、ピン留め、スター、ビュー、検索、認証、ボット、絵文字など |
さらに、cache_clearユーティリティツールを使用して、必要に応じてレスポンスキャッシュをクリアできます。
公式APIを超えた機能
15の非公開およびレガシーエンドポイントがあり、これはSlack自身のアプリが使用する内部APIと同じものです。セッショントークン (xoxc+xoxd)が必要です。
セッションエンドポイント — 公式APIでは公開されていないワークスペースの状態
| エンドポイント |
提供する情報 |
client.boot |
ワークスペースの完全なブートストラップ — チャンネル、ユーザー、設定、機能フラグ |
client.counts |
チャンネル/DM/スレッドごとの未読数とメンション数 |
client.userBoot |
認証されたユーザーに限定されたユーザー固有のブートストラップデータ |
threads.getView |
スレッドインボックス — 既読/未読状態を含むスレッドのリスト |
レガシーエンドポイント — 公式APIに欠けている機能
| エンドポイント |
提供する情報 |
chat.command |
スラッシュコマンドをプログラムで実行する |
commands.list |
カスタムコマンドを含むすべてのスラッシュコマンドを一覧表示する |
files.edit |
ファイルのタイトル、内容、またはファイルタイプをその場で編集する |
files.share |
ファイルをチャンネルに共有する |
bots.list |
ワークスペース内のすべてのボットユーザーを一覧表示する |
team.prefs.get |
チームレベルの設定 — 保持期間、権限、ドメイン |
users.prefs.get |
すべてのユーザー設定 — 通知、サイドバー、テーマ |
users.prefs.set |
個々のユーザー設定を設定する |
users.admin.invite |
ユーザーをメールで招待する (Enterprise Grid) |
users.admin.setInactive |
ユーザーアカウントを無効にする (Enterprise Grid) |
channels.delete |
非推奨のメソッド — 完全性のために含まれています |
🔧 認証について
| 変数 |
必須 |
説明 |
SLACK_XOXP_TOKEN |
はい |
SlackアプリのユーザーOAuthトークン |
SLACK_XOXC_TOKEN |
いいえ |
非公開エンドポイント用のブラウザセッショントークン |
SLACK_XOXD_TOKEN |
いいえ |
ブラウザセッションクッキー (xoxcとペアになっています) |
公式トークンとセッショントークンの違い: xoxpトークンは193の公式APIツールすべてをカバーします。非公開エンドポイント (未読数、ワークスペースのブート、ファイル編集) を使用するには、xoxc+xoxdも必要です。これらは、slack.comにログインしている間にブラウザのクッキーから取得できます。
🔧 キャッシュについて
レスポンスは自動的にキャッシュされ、API呼び出しを減らします。
- 安定したデータ (ユーザー、チーム、ボット、絵文字) — TTL 1時間
- 動的なデータ (チャンネルリスト、メンバー、ブックマーク) — TTL 5分
- 古いスレッド (
conversations_repliesでtsが1時間以上前のもの) — TTL 1時間
- 限定された履歴 (
conversations_historyで古い日付範囲のもの) — TTL 1時間
最新のデータが必要な場合は、cache_clearツールを使用してキャッシュをクリアします。
🔧 開発方法
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
📄 ライセンス
MIT