slack-read-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SLACK_BOT_TOKEN | No | Bot User OAuth Token (xoxb-...) to override token file. | |
| SLACK_TOKEN_FILE | No | Path to file containing the bot token. Overrides default ~/.slack-read-mcp/token. | |
| SLACK_CHANNELS_FILE | No | Path to channels JSON file. Overrides default ~/.slack-read-mcp/channels.json. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_channelsA | 読み取り対象として設定されているチャンネルの一覧を返す。Slack へは問い合わせない。ここに載っていても Bot が招待されていなければ読めない。 |
| get_channel_historyA | チャンネルのメッセージを新しい順に取得する。oldest に前回の ts を渡すと差分だけ取れる。スレッド返信は含まれない（reply_count > 0 のメッセージには get_thread_replies が必要）。各メッセージの reactions も返す（Bot に reactions:read スコープが無い場合は省略される）。Bot が参加していない場合は not_in_channel または channel_not_found になる。 |
| list_active_threadsA | since 以降に動きのあったものだけを返す巡回用ツール。チャンネル履歴を oldest まで遡って親メッセージを集め、(1) since より新しい投稿、(2) since より新しい返信が付いたスレッド（latest_reply で判定）を抽出する。返信本文は含まない（動いたスレッドは get_thread_replies を oldest 付きで読む）。本文は先頭 1 行のみに切り詰めるので、更新のないスレッドを読まされることがない。since には前回巡回した時刻（ts か ISO 8601）を渡す。 |
| get_thread_repliesA | スレッドの返信を取得する。親メッセージの ts を渡す。oldest を渡すと、それより新しい返信だけ返す（親も含めない）。oldest を渡さない場合は親メッセージを含めて全件返す（ページ送りで最大 2000 件）。 |
| resolve_userA | ユーザー ID を表示名・実名に解決する。本文中の <@U…> を人名に直すのに使う。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
get_channel_history and get_thread_replies are explicitly separated by thread inclusion, while list_active_threads is a polling summary tool that points to where to read next. list_channels and resolve_user operate on clearly different resources, so no two tools are likely to be confused.
All tool names follow a consistent snake_case verb_noun pattern: get for direct reads, list for enumeration, and resolve for user lookup. The naming is uniform and predictable across the entire set.
Five tools is a compact and appropriate surface for a read-only Slack integration. Each tool provides a distinct read operation with no unnecessary duplication or bloat.
The core read workflows are covered: channel enumeration, message history, thread replies, active-thread polling, and user ID resolution. Minor gaps such as listing all users or fetching a single message by ID prevent a perfect score but do not block typical use.