Slack MCP Server

Slack MCP Server

适用于 Slack 工作区的 Model Context Protocol（MCP）服务。功能最强大的 Slack MCP 服务——支持 Stdio、SSE 和 HTTP 传输、代理设置、私信、群组私信、智能历史记录获取（按日期或数量），可通过 OAuth 使用，也可在工作区中无需权限和作用域、完全隐身运行 😏。

重要

我们需要您的支持！每月有超过 30,000 名工程师访问此代码库，已有 9,000 多人正在使用它。

如果您认可我们的贡献者为这个项目付出的努力，请考虑为此代码库点亮一颗星。

这个功能丰富的 Slack MCP Server 具备以下功能：

• 隐身模式和 OAuth 模式：运行服务时无需额外权限或安装机器人（隐身模式），也可以使用安全的 OAuth 令牌进行访问，无需刷新令牌或从浏览器中提取令牌（OAuth 模式）。
• 支持企业工作区：可与企业版 Slack 设置集成。
• 支持频道和线程，并支持 #Name @Lookup：获取频道和线程中的消息，包括活动消息；既可通过名称（例如 #general）获取频道，也可通过频道 ID 获取。
• 智能历史记录：按日期（d1、7d、1m）或消息数量分页获取消息。
• 未读消息：高效获取所有频道中的未读消息，并按优先级排序（私信 > 合作伙伴频道 > 内部频道），支持 @提及筛选和标记为已读。
• 搜索消息：使用日期、用户和内容等各种筛选条件，在频道、线程和私信中搜索消息。
• 安全发布消息：出于安全考虑，默认禁用 conversations_add_message 工具。可通过环境变量启用，也可选择限制频道。
• 支持私信和群组私信：获取私信和群组私信。
• 嵌入用户信息：在消息中嵌入用户信息，以提供更丰富的上下文。
• 支持缓存：缓存用户和频道，以加快访问速度。
• Stdio/SSE/HTTP 传输和代理支持：可通过支持 Stdio、SSE 或 HTTP 传输的任何 MCP 客户端使用此服务；如有需要，也可配置服务通过代理路由发出的请求。

分析演示

添加消息演示

工具

1. conversations_history：

按 channel_id 获取频道（或私信）中的消息；如果响应的最后一行/列不为空，则将其用作分页的“cursor”参数。

• 参数：
  • channel_id（字符串，必填）： - channel_id（字符串）：频道 ID，格式为 Cxxxxxxxxxx；也可以是以 #... 或 @... 开头的频道名称，例如 #general 或 @username_dm。
  • include_activity_messages（布尔值，默认值：false）：如果为 true，响应将包含 channel_join 或 channel_leave 等活动消息。默认值为 false。
  • cursor（字符串，可选）：分页游标。使用上一次请求返回的响应中最后一行和列的值，作为 next_cursor 字段。
  • limit（字符串，默认值："1d"）：要获取的消息数量限制，格式可以是最长时间范围（例如，1d 表示 1 天、1w 表示 1 周、30d 表示 30 天、90d 表示 90 天；这是免费套餐历史记录的默认限制），也可以是消息数量（例如 50）。提供 cursor 时必须留空。

2. conversations_replies：

根据 channelID 和 thread_ts 获取对话中发布的一组消息。如果响应中的最后一行/列不为空，则将其用作分页的 cursor 参数。

• 参数：
  • channel_id（字符串，必需）：频道 ID，格式为 Cxxxxxxxxxx，或以 #... 或 @... 开头的名称，例如 #general 或 @username_dm。
  • thread_ts（字符串，必需）：线程父消息或线程中某条消息的唯一标识符。ts 必须是现有消息的时间戳，格式为 1234567890.123456，且该消息可以有 0 条或多条回复。
  • include_activity_messages（布尔值，默认值：false）：如果为 true，响应将包含活动消息，例如 'channel_join' 或 'channel_leave'。默认值为布尔值 false。
  • cursor（字符串，可选）：分页游标。使用上一次请求返回的响应中最后一行和一列的值作为 next_cursor 字段。
  • limit（字符串，默认值："1d"）：要获取的消息数量上限，可以是时间范围（例如 1d - 1 天、1w - 1 周、30d - 30 天、90d - 90 天，后者是免费套餐历史记录的默认上限），也可以是消息条数（例如 50）。提供 'cursor' 时必须为空。

3. conversations_add_message

根据 channel_id 和 thread_ts，向公开频道、私密频道或直接消息（DM 或 IM）对话添加消息。

注意： 出于安全考虑，默认禁用消息发布功能。要启用此功能，请设置 SLACK_MCP_ADD_MESSAGE_TOOL 环境变量。如果设置为以逗号分隔的频道 ID 列表，则仅允许在这些指定频道中发布消息。详情请参阅下文的 Environment Variables 部分。

• 参数：
  • channel_id（字符串，必需）：频道 ID，格式为 Cxxxxxxxxxx，或以 #... 或 @... 开头的名称，例如 #general 或 @username_dm。
  • thread_ts（字符串，可选）：线程父消息或线程中某条消息的唯一标识符。thread_ts 必须是现有消息的时间戳，格式为 1234567890.123456，且该消息可以有 0 条或多条回复。此参数为可选项；如果未提供，消息将添加到频道本身，否则将添加到线程中。
  • payload（字符串，必需）：指定 content_type 格式的消息内容。例如，text/plain 格式的消息为 'Hello, world!'，text/markdown 格式的消息为 '# Hello, world!'。
  • content_type（字符串，默认值："text/markdown"）：消息的内容类型。默认值为 'text/markdown'。允许的值：'text/markdown'、'text/plain'。

4. conversations_search_messages

使用筛选条件在公共频道、私有频道或直接消息（DM 或 IM）对话中搜索消息。所有筛选条件均为可选项；如果未提供任何筛选条件，则必须提供 search_query。

注意：使用机器人令牌（xoxb-*）时无法使用此工具。机器人令牌无法调用 search.messages API。

• 参数：
  • search_query（字符串，可选）：用于筛选消息的搜索查询。例如：'marketing report'，或 Slack 消息的完整 URL，例如 'https://slack.com/archives/C1234567890/p1234567890123456'。此时，工具将返回与给定 URL 匹配的单条消息，并忽略所有其他参数。
  • filter_in_channel（字符串，可选）：按特定频道的 ID 或名称筛选消息。例如：C1234567890 或 #general。如果未提供，将搜索所有频道。
  • filter_in_im_or_mpim（字符串，可选）：按直接消息（DM）或多人直接消息（MPIM）对话的 ID 或名称筛选消息。例如：D1234567890 或 @username_dm。如果未提供，将搜索所有 DM 和 MPIM。
  • filter_users_with（字符串，可选）：按线程和 DM 中的特定用户 ID 或显示名称筛选消息。例如：U1234567890 或 @username。如果未提供，将搜索所有线程和 DM。
  • filter_users_from（字符串，可选）：按特定用户的 ID 或显示名称筛选消息。例如：U1234567890 或 @username。如果未提供，将搜索所有用户。
  • filter_date_before（字符串，可选）：按特定日期之前发送的消息进行筛选，日期格式为 YYYY-MM-DD。例如：2023-10-01、July、Yesterday 或 Today。如果未提供，将搜索所有日期。
  • filter_date_after（字符串，可选）：按特定日期之后发送的消息进行筛选，日期格式为 YYYY-MM-DD。例如：2023-10-01、July、Yesterday 或 Today。如果未提供，将搜索所有日期。
  • filter_date_on（字符串，可选）：按特定日期当天发送的消息进行筛选，日期格式为 YYYY-MM-DD。例如：2023-10-01、July、Yesterday 或 Today。如果未提供，将搜索所有日期。
  • filter_date_during（字符串，可选）：按特定时间段内发送的消息进行筛选，日期格式为 YYYY-MM-DD。例如：July、Yesterday 或 Today。如果未提供，将搜索所有日期。
  • filter_threads_only（布尔值，默认值：false）：如果为 true，响应将仅包含线程中的消息。默认值为布尔值 false。
  • cursor（字符串，默认值：""）：用于分页的游标。将上一次请求返回的响应中最后一行和最后一列的值用作 next_cursor 字段。
  • limit（数字，默认值：20）：要返回的项目数上限。必须是 1 到 100 之间的整数。

5. channels_list：

获取频道列表

• 参数：
  • channel_types（字符串，必填）：以逗号分隔的频道类型。允许的值：mpim、im、public_channel、private_channel。例如：public_channel,private_channel,im
  • sort（字符串，可选）：排序类型。允许的值：popularity——按各频道中的成员／参与者数量排序。
  • limit（数字，默认值：100）：要返回的项目数上限。必须是 1 到 1000 之间的整数（最大值为 999）。
  • cursor（字符串，可选）：用于分页的游标。将上一次请求返回的响应中最后一行和最后一列的值用作 next_cursor 字段。

6. reactions_add:

在公开频道、私有频道或直接消息（DM 或 IM）对话中的消息添加表情回应。

**注意：**出于安全考虑，默认禁用添加表情回应功能。要启用此功能，请设置 SLACK_MCP_REACTION_TOOL 环境变量。如果该变量的值为以逗号分隔的频道 ID 列表，则仅对这些指定频道启用表情回应。详情请参阅下文的“环境变量”部分。

• 参数：
  • channel_id（字符串，必填）：频道 ID，格式为 Cxxxxxxxxxx；也可以使用以 #... 或 @... 开头的频道名称，例如 #general 或 @username_dm。
  • timestamp（字符串，必填）：要添加表情回应的消息时间戳，格式为 1234567890.123456。
  • emoji（字符串，必填）：要添加为表情回应的表情名称（不带冒号）。例如：thumbsup、heart、rocket。

7. reactions_remove:

从公开频道、私有频道或直接消息（DM 或 IM）对话中的消息移除表情回应。

**注意：**移除表情回应遵循与 reactions_add 相同的权限模型。要启用此功能，请设置 SLACK_MCP_REACTION_TOOL 环境变量。

• 参数：
  • channel_id（字符串，必填）：频道 ID，格式为 Cxxxxxxxxxx；也可以使用以 #... 或 @... 开头的频道名称，例如 #general 或 @username_dm。
  • timestamp（字符串，必填）：要移除表情回应的消息时间戳，格式为 1234567890.123456。
  • emoji（字符串，必填）：要移除的表情回应名称（不带冒号）。例如：thumbsup、heart、rocket。

8. users_search:

按姓名、电子邮件或显示名称搜索用户。返回用户详情，以及可用时的 DM 频道 ID。

**注意：**对于 OAuth 令牌（xoxp/xoxb），此工具会使用模式匹配搜索本地用户缓存。对于浏览器会话令牌（xoxc/xoxd），此工具会使用 Slack edge API 实时搜索。

• 参数：

  • query（字符串，必填）：搜索查询，可匹配真实姓名、显示名称、用户名或电子邮件。
  • limit（数字，默认值：10）：要返回的最大结果数（1-100）。

• **返回：**包含以下字段的 CSV：

  • UserID：用户 ID（例如 U1234567890）
  • UserName：Slack 用户名
  • RealName：用户真实姓名
  • DisplayName：用户显示名称
  • Email：用户电子邮件地址
  • Title：用户职位
  • DMChannelID：缓存中可用时的 DM 频道 ID（用于快速发送消息）

9. usergroups_list:

列出工作区中的所有用户组（子团队）。

• 参数：

  • include_users（布尔值，默认值：false）：包含每个组中的用户 ID 列表。
  • include_count（布尔值，默认值：true）：包含每个组的用户数。
  • include_disabled（布尔值，默认值：false）：包含已禁用或已归档的组。

• **返回：**包含以下字段的 CSV：id、name、handle、description、user_count、is_external

必需的 OAuth 作用域：usergroups:read

10. usergroups_create:

在工作区中创建新的用户组。

• 参数：

  • name（字符串，必填）：用户组名称（例如，“Engineering Team”）。
  • handle（字符串，可选）：不带 @ 的提及标识（例如，“engineering”）。如果未提供，Slack 会自动生成。
  • description（字符串，可选）：组的用途或说明。
  • channels（字符串，可选）：以逗号分隔的频道 ID，用于指定提及该组时会高亮显示的默认频道。

• **返回：**包含已创建组详情（id、name、handle、description）的 JSON

必需的 OAuth 作用域：usergroups:write

11. usergroups_update：

更新现有用户组的元数据。

• 参数：

  • usergroup_id（字符串，必填）：用户组 ID（例如，“S1234567890”）。
  • name（字符串，可选）：用户组的新名称。
  • handle（字符串，可选）：新的提及标识。
  • description（字符串，可选）：新的描述。
  • channels（字符串，可选）：新的默认频道（以逗号分隔的 ID）。此项会替换现有默认频道。

• **返回：**包含更新后用户组详情的 JSON

所需 OAuth 权限范围： usergroups:write

12. usergroups_users_update：

更新用户组成员。此操作会替换所有现有成员。

• 参数：

  • usergroup_id（字符串，必填）：用户组 ID（例如，“S1234567890”）。
  • users（字符串，必填）：要设为成员的用户 ID，以逗号分隔（例如，“U123,U456,U789”）。

• **返回：**包含更新后用户组详情及新增用户列表的 JSON

所需 OAuth 权限范围： usergroups:write

13. usergroups_me：

管理你在用户组中的成员身份：列出你所属的用户组、加入用户组或退出用户组。

• 参数：

  • action（字符串，必填）：要执行的操作：list 用于查看你的用户组，join 用于加入用户组，leave 用于退出用户组。
  • usergroup_id（字符串，可选）：用户组 ID（例如，“S1234567890”）。执行 join 和 leave 操作时必填。

• 返回：

  • 对于 list：包含你所属用户组的 CSV
  • 对于 join/leave：包含结果消息和更新后用户组信息的 JSON

所需 OAuth 权限范围： usergroups:read（用于 list）、usergroups:read + usergroups:write（用于 join/leave）

14. conversations_unreads

高效获取所有频道中的未读消息。使用一次 API 调用识别有未读消息的频道，然后仅获取这些频道中的消息。结果按优先级排序：私信 > 合作伙伴频道（Slack Connect）> 内部频道。

**注意：**此工具最适合使用浏览器会话令牌（xoxc/xoxd），此类令牌会使用高效的 client.counts API。对于标准 OAuth 令牌（xoxp），则会使用基于 conversations.info 的备用方法，该方法需要为每个频道调用一次 API，在大型工作区中可能较慢。Bot 令牌（xoxb）不可使用此工具。

• 参数：
  • include_messages（布尔值，默认值：true）：如果为 true，则返回实际的未读消息；如果为 false，则仅返回有未读消息的频道摘要。
  • channel_types（字符串，默认值："all"）：按频道类型筛选：all、dm（私信）、group_dm（群组私信）、partner（外部共享频道）、internal（常规工作区频道）。
  • max_channels（数字，默认值：50）：获取未读消息的频道数量上限。
  • max_messages_per_channel（数字，默认值：10）：每个频道获取的消息数量上限。
  • mentions_only（布尔值，默认值：false）：如果为 true，则仅返回提及了你的频道。注意：此筛选条件仅适用于浏览器令牌；OAuth 令牌会返回所有有未读消息的频道。

15. conversations_mark

将频道或私信标记为已读。

**注意：**出于安全考虑，默认禁用将消息标记为已读的功能。若要启用，请将 SLACK_MCP_MARK_TOOL 环境变量设为 true 或 1。详情请参阅下文的环境变量部分。

• 参数：
  • channel_id（字符串，必填）：频道 ID，格式为 Cxxxxxxxxxx；也可以是以 #... 或 @... 开头的频道名称（例如，#general、@username）。
  • ts（字符串，可选）：标记为已读的消息时间戳。如果未提供，则将所有消息标记为已读。

16. saved_list

列出 Slack“稍后保存”面板中的已保存项目。返回用户保存的项目，可选择附带消息内容。此工具取代已弃用的 stars.list API（更新日志）。

Note: 此工具需要浏览器会话令牌（xoxc/xoxd）。标准 OAuth（xoxp）或机器人（xoxb）令牌无法使用此工具。

• Parameters:
  • filter（string，默认 "saved"）：筛选已保存项目："saved"（进行中）、"completed"（已标记为完成）、"archived"。
  • limit（number，默认 50）：返回的项目数量上限。自动分页。
  • include_messages（boolean，默认 true）：若为 true，则获取实际保存的消息内容；若为 false，则仅返回元数据。
  • max_messages_per_item（number，默认 5）：每个已保存项目最多获取的消息数（用于线程回复）。

17. saved_update

更新已保存项目：标记为已完成、设置截止日期／提醒，或两者兼做。使用 saved_list 输出中的 item_id 和 ts 值。此工具取代已弃用的 stars.add／stars.remove API。

Note: 此工具需要浏览器会话令牌（xoxc/xoxd）。标准 OAuth（xoxp）或机器人（xoxb）令牌无法使用此工具。

• Parameters:
  • item_id（string，必填）：保存的消息所在频道／私信的 ID（来自 saved_list 输出）。
  • ts（string，必填）：已保存项目的消息时间戳（来自 saved_list 输出）。
  • mark（string，可选）：设为 "completed" 可将项目标记为已完成。
  • date_due（number，可选）：截止日期／提醒的 Unix 时间戳。设为 0 可清除。

18. saved_clear_completed

清除“稍后保存”面板中的所有已完成项目。这是一项批量操作，会移除所有 state="completed" 的项目。

Note: 此工具需要浏览器会话令牌（xoxc/xoxd）。标准 OAuth（xoxp）或机器人（xoxb）令牌无法使用此工具。

• Parameters: 无。

资源

Slack MCP Server 提供两个特殊目录资源，方便访问工作区元数据：

1. slack://<workspace>/channels — 频道目录

获取工作区中所有频道的 CSV 目录，包括公开频道、私人频道、私信和群组私信。

• URI： slack://<workspace>/channels
• 格式： text/csv
• 字段：
  • id：频道 ID（例如，C1234567890）
  • name：频道名称（例如，#general、@username_dm）
  • topic：频道主题（如有）
  • purpose：频道用途／说明
  • memberCount：频道成员数量

2. slack://<workspace>/users — 用户目录

获取工作区中所有用户的 CSV 目录。

• URI： slack://<workspace>/users
• 格式： text/csv
• 字段：
  • userID：用户 ID（例如，U1234567890）
  • userName：Slack 用户名（例如，john）
  • realName：用户真实姓名（例如，John Doe）

设置指南

• 身份验证设置
• 安装
• 配置和使用

环境变量（速查）

变量	必填？	默认值	说明
SLACK_MCP_XOXC_TOKEN	是*	nil	Slack 浏览器令牌（xoxc-...）
SLACK_MCP_XOXD_TOKEN	是*	nil	Slack 浏览器 Cookie d（xoxd-...）
SLACK_MCP_XOXP_TOKEN	是*	nil	用户 OAuth 令牌（xoxp-...）——可替代 xoxc/xoxd
SLACK_MCP_XOXB_TOKEN	是*	nil	Bot 令牌（xoxb-...）——可替代 xoxp/xoxc/xoxd。Bot 的访问权限有限（仅限受邀加入的频道，且无法搜索）
SLACK_MCP_PORT	否	13080	MCP 服务监听的端口
SLACK_MCP_HOST	否	127.0.0.1	MCP 服务监听的主机
SLACK_MCP_API_KEY	否	nil	SSE 和 HTTP 传输使用的 Bearer 令牌
SLACK_MCP_PROXY	否	nil	出站请求使用的代理 URL
SLACK_MCP_USER_AGENT	否	nil	自定义 User-Agent（适用于 Enterprise Slack 环境）
SLACK_MCP_CUSTOM_TLS	否	nil	根据 SLACK_MCP_USER_AGENT 或默认 User-Agent 向 Slack 服务发送自定义 TLS 握手。（适用于 Enterprise Slack 环境）
SLACK_MCP_SERVER_CA	否	nil	CA 证书路径
SLACK_MCP_SERVER_CA_TOOLKIT	否	nil	将 HTTPToolkit CA 证书注入根信任存储区，以便进行中间人调试
SLACK_MCP_SERVER_CA_INSECURE	否	false	信任所有不安全请求（不推荐）
SLACK_MCP_ADD_MESSAGE_TOOL	否	nil	将此项设为 true 可在所有频道中启用通过 conversations_add_message 发布消息；也可设置为以逗号分隔的频道 ID 列表，以将特定频道加入允许列表；或在频道 ID 前使用 !，以允许除指定频道外的所有频道。如果为空，则仅当在 SLACK_MCP_ENABLED_TOOLS 中明确列出时才会注册此工具。
SLACK_MCP_ADD_MESSAGE_MARK	否	nil	启用 conversations_add_message（通过 SLACK_MCP_ADD_MESSAGE_TOOL 或 SLACK_MCP_ENABLED_TOOLS）后，将此项设为 true 可自动将已发送的消息标记为已读。
SLACK_MCP_ADD_MESSAGE_UNFURLING	否	nil	启用后，允许 Slack 展开已发布的链接；也可设置为以逗号分隔的域名列表，例如 github.com,slack.com，仅允许展开这些域名的链接。如果文本中包含允许列表中的域名和未知域名，出于安全原因将禁用链接展开。
SLACK_MCP_REACTION_TOOL	否	nil	将此项设为 true 可在所有频道中启用 reactions_add 和 reactions_remove 工具；也可设置为以逗号分隔的频道 ID 列表，以将特定频道加入允许列表；或在频道 ID 前使用 !，以允许除指定频道外的所有频道。如果为空，则仅当在 SLACK_MCP_ENABLED_TOOLS 中明确列出时才会注册这些工具。
SLACK_MCP_ATTACHMENT_TOOL	否	nil	将此项设为 true、1 或 yes 可启用 attachment_get_data 工具。不支持按频道设置限制。如果为空，则仅当在 SLACK_MCP_ENABLED_TOOLS 中明确列出时才会注册此工具。
SLACK_MCP_MARK_TOOL	否	nil	将此项设为 true 或 1 可启用 conversations_mark 工具。默认禁用，以防意外将消息标记为已读。
SLACK_MCP_USERS_CACHE	否	~/Library/Caches/slack-mcp-server/users_cache.json (macOS) ~/.cache/slack-mcp-server/users_cache.json (Linux) %LocalAppData%/slack-mcp-server/users_cache.json (Windows)	用户缓存文件的路径。用于缓存 Slack 用户信息，避免启动时重复调用 API。
SLACK_MCP_CHANNELS_CACHE	否	~/Library/Caches/slack-mcp-server/channels_cache_v2.json (macOS) ~/.cache/slack-mcp-server/channels_cache_v2.json (Linux) %LocalAppData%/slack-mcp-server/channels_cache_v2.json (Windows)	频道缓存文件的路径。用于缓存 Slack 频道信息，避免启动时重复调用 API。
SLACK_MCP_LOG_LEVEL	否	info	stdout 或 stderr 的日志级别。有效值包括：debug、info、warn、error、panic 和 fatal
SLACK_MCP_GOVSLACK	否	nil	设为 true 可启用 GovSlack 模式。将 API 调用路由到 slack-gov.com 端点，而非 slack.com，以支持符合 FedRAMP 标准的政府工作区。
SLACK_MCP_ENABLED_TOOLS	否	nil	要注册的工具的逗号分隔列表。如果为空，则注册所有只读工具和用户组工具；写入工具（conversations_add_message、reactions_add、reactions_remove、attachment_get_data）需要设置各自的环境变量，或必须在此处明确列出。在此处列出写入工具后，该工具将启用且不受频道限制。可用工具：conversations_history、conversations_replies、conversations_add_message、reactions_add、reactions_remove、attachment_get_data、conversations_search_messages、channels_list、usergroups_list、usergroups_me、usergroups_create、usergroups_update、usergroups_users_update。
*你需要以下认证凭据之一：xoxp（用户）、xoxb（机器人），或同时提供 xoxc/xoxd 令牌。

限制矩阵与缓存

用户缓存	频道缓存	限制
:x:	:x:	无缓存，无法使用用户数据增强大模型上下文，工具 channels_list 将完全无法使用。工具 conversations_* 的功能会受限，无法通过 @userHandle 或 #channel-name 搜索消息，也无法通过 @userHandle 或 #channel-name 获取消息。
:white_check_mark:	:x:	无频道缓存，工具 channels_list 将完全无法使用。工具 conversations_* 的功能会受限，无法通过 @userHandle 或 #channel-name 搜索消息，也无法通过 @userHandle 或 #channel-name 获取消息。
:white_check_mark:	:white_check_mark:	无限制，Slack MCP 服务功能完整。

调试工具

# Run the inspector with stdio transport
npx @modelcontextprotocol/inspector go run mcp/mcp-server.go --transport stdio

# View logs
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

• 切勿分享 API 令牌
• 确保 .env 文件安全且私密

许可证

基于 MIT 许可授权，详见 LICENSE 文件。这不是 Slack 官方产品。