Slack
Slack workspace connector to browse channels, read conversations and threads, post messages and replies, react, look up members and share files.
Tools
Ask an agent for what you need in plain language — it picks the right tool itself. You can also limit which of these an agent may use, and require your approval before any of them runs.
List the channels of the Slack workspace with their ids, names, topics and whether the bot is a member. The bot can only read or post in channels where isMember is true; ask a workspace member to run "/invite @<app>" in a channel to add it.
| Parameter | Type | Description |
|---|---|---|
| types | "public" | "private" | "all" | Channel kinds to list: public, private (only those the bot is a member of) or all (default). |
| excludeArchived | boolean | Skip archived channels (default true). |
| limit | integer | Items per page (1-200); defaults to 50. |
| cursor | string | Cursor from a previous call's nextCursor to fetch the next page; omit for the first page. |
Get a Slack channel: name, topic, purpose, member count, whether it is private or archived and whether the bot is a member.
| Parameter | Type | Description |
|---|---|---|
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
Read the messages of a Slack channel the bot is a member of, newest first. Thread replies are not included: a message with replyCount > 0 is a thread parent, read it with getThreadReplies. Author ids (userId) are not resolved to names; use getUser or listUsers when names matter.
| Parameter | Type | Description |
|---|---|---|
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
| oldest | string | Only messages after this point. A Slack message ts ("1700000000.123456") or an ISO-8601 date-time. |
| latest | string | Only messages before this point. A Slack message ts ("1700000000.123456") or an ISO-8601 date-time. |
| limit | integer | Items per page (1-200); defaults to 50. |
| cursor | string | Cursor from a previous call's nextCursor to fetch the next page; omit for the first page. |
Read a Slack thread: the parent message followed by its replies, oldest first. Author ids are not resolved to names; use getUser when names matter.
| Parameter | Type | Description |
|---|---|---|
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
| threadTsrequired | string | ts of the thread parent message (from getChannelHistory). |
| limit | integer | Items per page (1-200); defaults to 50. |
| cursor | string | Cursor from a previous call's nextCursor to fetch the next page; omit for the first page. |
Post a message to a Slack channel as the app, or reply in a thread when threadTs is given. The bot must be a member of the channel (see listChannels); if it is not, ask a workspace member to run "/invite @<app>" in the channel.
| Parameter | Type | Description |
|---|---|---|
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
| textrequired | string | Message text in Slack mrkdwn: *bold*, _italic_, ~strike~, `code`, ```code block```, > quote, <https://url|label>, <@U0123ABC> to mention a user, <#C0123ABC> to link a channel. Markdown headings, tables and ** are not supported. |
| threadTs | string | Reply in this thread (ts of the parent message); omit to post a new message. |
| unfurlLinks | boolean | Show link previews (default true). |
List the members and bots of the Slack workspace with their ids, handles, names, emails and time zones.
| Parameter | Type | Description |
|---|---|---|
| includeDeleted | boolean | Include deactivated accounts (default false). |
| limit | integer | Items per page (1-200); defaults to 50. |
| cursor | string | Cursor from a previous call's nextCursor to fetch the next page; omit for the first page. |
Get a Slack workspace member by id: handle, real and display name, email, title and time zone.
| Parameter | Type | Description |
|---|---|---|
| userIdrequired | string | Slack user id (e.g. "U0123ABCDEF") as returned by listUsers or in messages. |
Add an emoji reaction to a Slack message as the app.
| Parameter | Type | Description |
|---|---|---|
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
| messageTsrequired | string | ts of the message to react to. |
| emojirequired | string | Emoji name without colons, e.g. "thumbsup", "white_check_mark", "eyes". |
Share a file from agent storage in a Slack channel (or thread) as the app, optionally with a message. The bot must be a member of the channel.
| Parameter | Type | Description |
|---|---|---|
| filePathrequired | string | Absolute path to the file in agent storage (e.g. "/chats/<chatId>/generated/call_abc123.png"). Use the exact path reported by the tool that produced the file. |
| channelIdrequired | string | Slack channel id (e.g. "C0123ABCDEF") as returned by listChannels. |
| threadTs | string | Share the file as a reply in this thread; omit to post it to the channel. |
| filename | string | Override the file name shown in Slack. |
| title | string | Title shown above the file in Slack. |
| initialComment | string | Message text (mrkdwn) posted together with the file. |
List files shared in the Slack workspace, newest first, optionally filtered by channel, uploader or date range. Only files in channels the bot is a member of are visible.
| Parameter | Type | Description |
|---|---|---|
| channelId | string | Only files shared in this channel. |
| userId | string | Only files uploaded by this user. |
| from | string | Only files created at or after this ISO-8601 date-time. |
| to | string | Only files created at or before this ISO-8601 date-time. |
| page | integer | Page number (1-based); this tool pages by number, not by cursor. |
| count | integer | Files per page (1-100); defaults to 25. |
Permissions
You choose what to grant on the provider's consent screen. A tool is only available to your agents if you granted the permission it needs, so granting less simply means fewer tools.
- channels:history
- channels:read
- chat:write
- files:read
- files:write
- groups:history
- groups:read
- reactions:write
- users:read