Summary
This is a read-only Slack integration that gives Claude access to your workspace without any write permissions. You get 15 tools covering the essentials: channel history, thread replies, message search, user profiles, file metadata, reactions, and starred items. It uses user OAuth tokens (xoxp-) for authentication and skips the official SDK in favor of direct HTTP calls via httpx, making the codebase easier to audit. The security model is worth noting if you're cautious about connecting AI to internal comms. Reach for this when you want Claude to search through Slack history, summarize threads, or pull context from channels without worrying about accidental posts or deletions.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
80 tools
SLACK_ACTIVATE_OR_MODIFY_DO_NOT_DISTURB_DURATIONDEPRECATED: Turns on Do Not Disturb mode for the current user, or changes its duration. Use `set_dnd_duration` instead.1 params
DEPRECATED: Turns on Do Not Disturb mode for the current user, or changes its duration. Use `set_dnd_duration` instead.
Parameters* required
num_minutesstringNumber of minutes, from now, to snooze until.
Example: "60"
SLACK_ADD_A_CUSTOM_EMOJI_TO_A_SLACK_TEAMDEPRECATED: Adds a custom emoji to a Slack workspace given a unique name and an image URL. Use `add_emoji` instead.3 params
DEPRECATED: Adds a custom emoji to a Slack workspace given a unique name and an image URL. Use `add_emoji` instead.
Parameters* required
urlstringThe URL of the image file to be used as the custom emoji. The image should be accessible via HTTP/HTTPS and meet Slack's emoji requirements (e.g., size, format). Supported formats typically include PNG, GIF, and JPEG.
Examples:
"https://example.com/emoji/partyparrot.gif"
"https://cdn.example.com/images/approved_stamp.png"
namestringThe desired name for the new custom emoji. This name will be used to invoke the emoji (e.g., if name is 'partyparrot', it's used as ':partyparrot:'). Colons around the name are not required when providing this field.
Examples:
"partyparrot"
"approved_stamp"
"team_logo_small"
tokenstringAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
SLACK_ADD_AN_EMOJI_ALIAS_IN_SLACKAdds an alias for an existing custom emoji in a Slack Enterprise Grid organization.3 params
Adds an alias for an existing custom emoji in a Slack Enterprise Grid organization.
Parameters* required
namestringThe new alias to be created for the emoji specified in `alias_for` (e.g., `new_emoji_alias`). Colons around the name (e.g., `:my_alias:`) are optional and will be automatically trimmed, along with any leading/trailing whitespace.
Examples:
"parrot_alias"
":approved_alias:"
tokenstringAuthentication token. Requires the `admin.teams:write` scope.
alias_forstringThe canonical name of the existing custom emoji (e.g., `original_emoji`).
Examples:
"party_parrot"
"approved_stamp"
SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICEAdds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique `external_id` and an `external_url` accessible by Slack.7 params
Adds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique `external_id` and an `external_url` accessible by Slack.
Parameters* required
titlestringTitle of the remote file to be displayed in Slack.
Examples:
"Project Proposal Q3.docx"
"Client Onboarding Checklist.pdf"
tokenstringSlack authentication token, required to authorize adding the remote file.
Example: "xoxp-123456789012-123456789012-1234567890123-abcdefghijklmnopqrstuvwxyz123456"
filetypestringFile type (e.g., 'pdf', 'docx', 'png') to help Slack display appropriate icons or previews.
Examples:
"pdf"
"docx"
"gdoc"
"png"
"txt"
"gsheet"
external_idstringUnique identifier for the file, defined by the calling application, used for future API references (e.g., updating, deleting).
Examples:
"file-abc-123-xyz-789"
"guid-document-42"
external_urlstringPublicly accessible or permissioned URL of the remote file, used by Slack to access its content or metadata.
Examples:
"https://example.com/path/to/your/file.pdf"
"https://your-service.com/files/unique-id-123"
preview_imagestringBase64-encoded image (e.g., PNG, JPEG) used as the file's preview in Slack.
Examples:
"(base64 encoded PNG data of a chart)"
"(base64 encoded JPEG data of a document cover)"
indexable_file_contentsstringPlain text content of the file, indexed by Slack for search.
Examples:
"This document contains project plans for Q4, focusing on market expansion and new product development."
"Meeting notes from Q1 review: Key discussion points included budget allocation, resource management, and upcoming deadlines."
SLACK_ADD_A_STAR_TO_AN_ITEMStars a channel, file, file comment, or a specific message in Slack.4 params
Stars a channel, file, file comment, or a specific message in Slack.
Parameters* required
filestringID of the file to add a star to.
Examples:
"F1234567890"
"F0987654321"
channelstringID of the channel to star. If starring a specific message, this is the ID of the channel containing the message, and `timestamp` must also be provided.
Examples:
"C1234567890"
"G0123456789"
timestampstringTimestamp of the message to add a star to. This uniquely identifies the message within the specified `channel`. Requires `channel` to also be provided.
Examples:
"1234567890.123456"
"1678886400.000100"
file_commentstringID of the file comment to add a star to.
Examples:
"Fc1234567890"
"Fc0987654321"
SLACK_ADD_CALL_PARTICIPANTSRegisters new participants added to a Slack call.2 params
Registers new participants added to a Slack call.
Parameters* required
idstringID of the call returned by the add method.
Example: "R0123456789"
usersstringThe list of users to add as participants in the call. users is a JSON array (formatted as a string) containing information for each user. Each element should include both a `slack_id` and optionally an `external_id`. For example: `[{"slack_id": "U1H77", "external_id": "ext-id"}]`.
Examples:
"[{\"slack_id\": \"U1H77\", \"external_id\": \"ext-id\"}]"
"[{\"slack_id\": \"U2ABC123\"}]"
SLACK_ADD_EMOJIAdds a custom emoji to a Slack workspace given a unique name and an image URL; subject to workspace emoji limits.3 params
Adds a custom emoji to a Slack workspace given a unique name and an image URL; subject to workspace emoji limits.
Parameters* required
urlstringThe URL of the image file to be used as the custom emoji. The image should be accessible via HTTP/HTTPS and meet Slack's emoji requirements (e.g., size, format). Supported formats typically include PNG, GIF, and JPEG.
Examples:
"https://example.com/emoji/partyparrot.gif"
"https://cdn.example.com/images/approved_stamp.png"
namestringThe desired name for the new custom emoji. This name will be used to invoke the emoji (e.g., if name is 'partyparrot', it's used as ':partyparrot:'). Colons around the name are not required when providing this field.
Examples:
"partyparrot"
"approved_stamp"
"team_logo_small"
tokenstringAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
SLACK_ADD_REACTION_TO_AN_ITEMAdds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions.3 params
Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions.
Parameters* required
namestringName of the emoji to add as a reaction (e.g., 'thumbsup'). This is the emoji name without colons. For emojis with skin tone modifiers, append '::skin-tone-X' where X is a number from 2 to 6 (e.g., 'wave::skin-tone-3').
Examples:
"thumbsup"
"grinning"
"robot_face"
"wave::skin-tone-3"
channelstringID of the channel where the message to add the reaction to was posted.
Examples:
"C1234567890"
"G0987654321"
timestampstringTimestamp of the message to which the reaction will be added. This is a unique identifier for the message, typically a string representing a float value like '1234567890.123456'.
Examples:
"1234567890.123456"
"1609459200.000200"
SLACK_ARCHIVE_A_PUBLIC_OR_PRIVATE_CHANNELArchives a Slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.1 params
Archives a Slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.
Parameters* required
channel_idstringID of the public or private Slack channel to archive.
Example: "C1234567890"
SLACK_ARCHIVE_A_SLACK_CONVERSATIONArchives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations.1 params
Archives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations.
Parameters* required
channelstringID of the Slack conversation to archive. This ID uniquely identifies a channel (e.g., public, private).
Example: "C1234567890"
SLACK_CHAT_POST_MESSAGEDEPRECATED: Posts a message to a Slack channel, direct message, or private channel. Use `send_message` instead.16 params
DEPRECATED: Posts a message to a Slack channel, direct message, or private channel. Use `send_message` instead.
Parameters* required
textstringDEPRECATED: This sends raw text only, use markdown_text field. Primary textual content. Recommended fallback if using `blocks` or `attachments`. Supports mrkdwn unless `mrkdwn` is `false`.
Examples:
"Hello from your friendly bot!"
"Reminder: Team meeting at 3 PM today."
parsestringMessage text parsing behavior. Default `none` (no special parsing). `full` parses as user-typed (links @mentions, #channels). See Slack API docs for details.
Examples:
"none"
"full"
blocksstringDEPRECATED: Use `markdown_text` field instead. URL-encoded JSON array of layout blocks for rich/interactive messages. See Slack API Block Kit docs for structure.
Example: "%5B%7B%22type%22%3A%20%22section%22%2C%20%22text%22%3A%20%7B%22type%22%3A%20%22mrkdwn%22%2C%20%22text%22%3A%20%22Hello%2C%20world%21%22%7D%7D%5D"
mrkdwnbooleanDisable Slack's markdown for `text` field if `false`. Default `true` (allows *bold*, _italic_, etc.).
as_userbooleanPost as the authenticated user instead of as a bot. Defaults to `false`. If `true`, `username`, `icon_emoji`, and `icon_url` are ignored. If `false`, the message is posted as a bot, allowing appearance customization.
channelstringID or name of the channel, private group, or IM channel to send the message to.
Examples:
"C1234567890"
"general"
icon_urlstringImage URL for bot's icon (must be HTTPS). Applies if `as_user` is `false`.
Example: "https://slack.com/img/icons/appDir_2019_01/Tonito64.png"
usernamestringBot's name in Slack (max 80 chars). Applies if `as_user` is `false`.
Examples:
"MyBot"
"AlertBot"
thread_tsstringTimestamp (`ts`) of an existing message to make this a threaded reply. Use `ts` of the parent message, not another reply. Example: '1476746824.000004'.
Example: "1618033790.001500"
icon_emojistringEmoji for bot's icon (e.g., ':robot_face:'). Overrides `icon_url`. Applies if `as_user` is `false`.
Examples:
":tada:"
":slack:"
link_namesbooleanAutomatically hyperlink channel names (e.g., #channel) and usernames (e.g., @user) in message text. Defaults to `false` for bot messages.
attachmentsstringURL-encoded JSON array of message attachments, a legacy method for rich content. See Slack API documentation for structure.
Example: "%5B%7B%22fallback%22%3A%20%22Required%20plain-text%20summary%20of%20the%20attachment.%22%2C%20%22color%22%3A%20%22%2336a64f%22%2C%20%22pretext%22%3A%20%22Optional%20text%20that%20appears%20above%20the%20attachment%20block%22%2C%20%22author_name%22%3A%20%22Bobby%20Tables%22%2C%20%22title%22%3A%20%22Slack%20API%20Documentation%22%2C%20%22title_link%22%3A%20%22https%3A%2F%2Fapi.slack.com%2F%22%2C%20%22text%22%3A%20%22Optional%20text%20that%20appears%20within%20the%20attachment%22%7D%5D"
unfurl_linksbooleanEnable unfurling of text-based URLs. Defaults `false` for bots, `true` if `as_user` is `true`.
unfurl_mediabooleanDisable unfurling of media content from URLs if `false`. Defaults to `true`.
markdown_textstringPREFERRED: Write your message in markdown for nicely formatted display. Supports: headers (# ## ###), bold (**text** or __text__), italic (*text* or _text_), strikethrough (~~text~~), inline code (`code`), code blocks (```), links ([text](url)), block quotes (>), lists (- item, 1. item), dividers (--- or ***), context blocks (:::context with images), and section buttons (:::section-button). IMPORTANT: Use \n for line breaks (e.g., 'Line 1\nLine 2'), not actual newlines. USER MENTIONS: To tag users, use their user ID with <@USER_ID> format (e.g., <@U1234567890>), not username.
Examples:
"# Status Update\n\nSystem is **running smoothly** with *excellent* performance.\n\n```bash\nkubectl get pods\n```\n\n> All services operational ✅"
"## Daily Report\n\n- **Deployments**: 5 successful\n- *Issues*: 0 critical\n- ~~Maintenance~~: **Completed**\n\n---\n\n**Next**: Monitor for 24h"
reply_broadcastbooleanIf `true` for a threaded reply, also posts to main channel. Defaults to `false`.
SLACK_CLEAR_STATUSClears the Slack status for the authenticated user, removing any custom text and emoji.
Clears the Slack status for the authenticated user, removing any custom text and emoji.
No parameter schema in public metadata yet.
SLACK_CLOSE_DM_OR_MULTI_PERSON_DMCloses a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view.1 params
Closes a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user's sidebar without deleting history; this action affects only the calling user's view.
Parameters* required
channelstringThe ID of the direct message or multi-person direct message channel to close. Example: D1234567890 or G0123456789.
Examples:
"D1234567890"
"G0123456789"
SLACK_CREATE_A_REMINDERCreates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm').3 params
Creates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm').
Parameters* required
textstringThe textual content of the reminder message.
Examples:
"Submit weekly report"
"Follow up with Jane Doe"
timestringSpecifies when the reminder should occur. This can be a Unix timestamp (integer, up to five years from now), the number of seconds until the reminder (integer, if within 24 hours, e.g., '300' for 5 minutes), or a natural language description (string, e.g., "in 15 minutes," or "every Thursday at 2pm", "daily").
Examples:
"1735689600"
"900"
"in 20 minutes"
"every Monday at 10am"
userstringThe ID of the user who will receive the reminder (e.g., 'U012AB3CD4E'). If not specified, the reminder will be sent to the user who created it.
Examples:
"U012AB3CD4E"
"W1234567890"
SLACK_CREATE_A_SLACK_USER_GROUPCreates a new User Group (often referred to as a subteam) in a Slack workspace.5 params
Creates a new User Group (often referred to as a subteam) in a Slack workspace.
Parameters* required
namestringUnique name for the User Group. Must be unique among all User Groups in the workspace.
Examples:
"Customer Support"
"Core Engineering"
"Project Phoenix Leads"
handlestringUnique mention handle. Must be unique across channels, users, and other User Groups. Max 21 chars; lowercase letters, numbers, hyphens, underscores only.
Examples:
"support-team"
"devs"
"project-phoenix-leads"
channelsstringComma-separated encoded channel IDs for default channels, suggested when mentioning or inviting the group.
Examples:
"C012AB3CD,C023BC4DE"
"C034CD5EF"
descriptionstringShort description for the User Group.
Examples:
"Manages all customer support inquiries."
"Core engineering team members."
include_countbooleanInclude the User Group's user count in the response. Server defaults to `false` if omitted.
SLACK_CREATE_CANVASCreates a new Slack Canvas with the specified title and optional content.3 params
Creates a new Slack Canvas with the specified title and optional content.
Parameters* required
titlestringThe title of the canvas to create
Examples:
"Project Planning"
"Team Meeting Notes"
"Sprint Retrospective"
channel_idstringOptional channel ID (e.g., 'C1234567890'). If provided, the canvas will be automatically added as a tab in this channel with write permissions.
Example: "C1234567890"
document_contentvalueOptional canvas content in Slack's document format. If not provided, creates an empty canvas.
Example: {"markdown":"# Welcome\n\nThis is a new canvas","type":"markdown"}
SLACK_CREATE_CHANNELInitiates a public or private channel-based conversation3 params
Initiates a public or private channel-based conversation
Parameters* required
namestringName of the public or private channel to create
Example: "mychannel"
team_idstringencoded team id to create the channel in, required if org token is used
Example: "T1234567890"
is_privatebooleanCreate a private channel instead of a public one
Example: true
SLACK_CREATE_CHANNEL_BASED_CONVERSATIONCreates a new public or private Slack channel with a unique name; the channel can be org-wide, or team-specific if `team_id` is given (required if `org_wide` is false or not provided).5 params
Creates a new public or private Slack channel with a unique name; the channel can be org-wide, or team-specific if `team_id` is given (required if `org_wide` is false or not provided).
Parameters* required
namestringName for the new channel. Must be unique, 80 characters or fewer, lowercase, without spaces or periods, and may contain letters, numbers, and hyphens.
Examples:
"project-alpha"
"marketing-campaign-q3"
"team-devs-internal"
team_idstringWorkspace (team) ID for channel creation (e.g., T123ABCDEFG). Required if `org_wide` is `false` or not set.
Example: "T123ABCDEFG"
org_widebooleanSet to `true` to make the channel available org-wide. If `false` or not set, `team_id` is required.
is_privatebooleanSet to `true` to make the channel private, or `false` for public.
descriptionstringOptional description for the channel (e.g., 'Discussion about Q4 marketing strategies').
SLACK_CUSTOMIZE_URL_UNFURLCustomizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews.6 params
Customizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews.
Parameters* required
tsstringTimestamp of the message to customize URL unfurling for.
Example: "1234567890.123456"
channelstringChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
Examples:
"C1234567890"
"general"
unfurlsstringURL-encoded JSON mapping message URLs to custom unfurl content (Slack attachment format or unfurl blocks). To remove an existing unfurl, provide an empty unfurl block for its URL.
Example: "%7B%22https%3A%2F%2Fexample.com%2Farticle%22%3A%7B%22text%22%3A%22Article%20Preview%22%7D%7D"
user_auth_urlstringURL-encoded custom URL for user authentication with your app to enable unfurling. Used when `user_auth_required` is true.
Example: "https://yourapp.com/slack/auth?user_id=U123&channel_id=C123"
user_auth_messagestringEphemeral message text prompting user authentication with your app for domain-specific unfurling. Used when `user_auth_required` is true and authorization is pending.
Example: "Please authenticate with MyApp to see rich previews for example.com."
user_auth_requiredbooleanSet to `true` if user authentication is required to unfurl links for a domain, enabling an authentication flow using `user_auth_url` and `user_auth_message`.
Examples:
true
false
SLACK_CUSTOMIZE_URL_UNFURLING_IN_MESSAGESDEPRECATED: Customizes URL previews (unfurling) in a specific Slack message. Use `customize_url_unfurl` instead.6 params
DEPRECATED: Customizes URL previews (unfurling) in a specific Slack message. Use `customize_url_unfurl` instead.
Parameters* required
tsstringTimestamp of the message to customize URL unfurling for.
Example: "1234567890.123456"
channelstringChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
Examples:
"C1234567890"
"general"
unfurlsstringURL-encoded JSON mapping message URLs to custom unfurl content (Slack attachment format or unfurl blocks). To remove an existing unfurl, provide an empty unfurl block for its URL.
Example: "%7B%22https%3A%2F%2Fexample.com%2Farticle%22%3A%7B%22text%22%3A%22Article%20Preview%22%7D%7D"
user_auth_urlstringURL-encoded custom URL for user authentication with your app to enable unfurling. Used when `user_auth_required` is true.
Example: "https://yourapp.com/slack/auth?user_id=U123&channel_id=C123"
user_auth_messagestringEphemeral message text prompting user authentication with your app for domain-specific unfurling. Used when `user_auth_required` is true and authorization is pending.
Example: "Please authenticate with MyApp to see rich previews for example.com."
user_auth_requiredbooleanSet to `true` if user authentication is required to unfurl links for a domain, enabling an authentication flow using `user_auth_url` and `user_auth_message`.
Examples:
true
false
SLACK_DELETE_A_COMMENT_ON_A_FILEDeletes a specific comment from a file in Slack; this action is irreversible.2 params
Deletes a specific comment from a file in Slack; this action is irreversible.
Parameters* required
idstringID of the comment to delete. This can be obtained when the comment is created or by listing file comments.
Example: "Fc1234567890"
filestringID of the file to delete a comment from. The file ID can be obtained using the `files.info` method or when a file is shared.
Example: "F1234567890"
SLACK_DELETE_A_FILE_BY_IDPermanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares.1 params
Permanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares.
Parameters* required
filestringID of the file to delete. Typically obtained when a file is uploaded or listed.
Examples:
"F2147483002"
"F012345AB67"
SLACK_DELETE_A_PUBLIC_OR_PRIVATE_CHANNELPermanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a Slack Enterprise Grid organization.1 params
Permanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a Slack Enterprise Grid organization.
Parameters* required
channel_idstringID of the channel to be permanently deleted. This channel can be public or private.
Example: "C0123456789"
SLACK_DELETE_A_SCHEDULED_MESSAGE_IN_A_CHATDeletes a pending, unsent scheduled message from the specified Slack channel, identified by its `scheduled_message_id`.3 params
Deletes a pending, unsent scheduled message from the specified Slack channel, identified by its `scheduled_message_id`.
Parameters* required
as_userbooleanPass `true` to delete the message as the authenticated user (bots are considered authed users here, uses `chat:write:user` scope); if `false` or omitted, deletes as a bot (uses `chat:write:bot` scope).
Examples:
"true"
"false"
channelstringID of the channel, private group, or DM conversation where the message is scheduled.
Examples:
"C1234567890"
"G0123456789"
"D0123456789"
scheduled_message_idstringUnique ID (`scheduled_message_id`) of the message to be deleted; obtained from `chat.scheduleMessage` response.
Examples:
"Q123ABCDEF456"
"SM0123456789"
SLACK_DELETE_A_SLACK_REMINDERDeletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.1 params
Deletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.
Parameters* required
reminderstringThe unique identifier of the reminder to be deleted. This ID is obtained when a reminder is created or listed.
Example: "Rm1234567890"
SLACK_DELETE_CANVASDeletes a Slack Canvas permanently.1 params
Deletes a Slack Canvas permanently.
Parameters* required
canvas_idstringThe unique identifier of the canvas to delete
Example: "F01234ABCDE"
SLACK_DELETES_A_MESSAGE_FROM_A_CHATDeletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.3 params
Deletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.
Parameters* required
tsstringTimestamp of the message to be deleted. Must be the exact Slack message timestamp string with fractional precision, e.g., '1234567890.123456'.
Examples:
"1234567890.123456"
"1609459200.000000"
as_userbooleanIf `True`, deletes the message as the authenticated user using the `chat:write:user` scope. Bot users are considered authenticated users. If `False` or omitted, the message is deleted using the `chat:write:bot` scope.
channelstringThe ID of the channel, private group, or direct message conversation containing the message to be deleted.
Examples:
"C1234567890"
"G0987654321"
"D060123ABC"
SLACK_DELETE_USER_PROFILE_PHOTODeletes the Slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set.1 params
Deletes the Slack profile photo for the user identified by the token, reverting them to the default avatar; this action is irreversible and succeeds even if no custom photo was set.
Parameters* required
tokenstringAuthentication token identifying the user whose profile photo will be deleted.
Example: "xoxp-YOUR_SLACK_LEGACY_TOKEN"
SLACK_DISABLE_AN_EXISTING_SLACK_USER_GROUPDisables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its 'date_delete' timestamp; the group is not permanently deleted and can be re-enabled.2 params
Disables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its 'date_delete' timestamp; the group is not permanently deleted and can be re-enabled.
Parameters* required
usergroupstringUnique encoded ID of the User Group to disable.
Examples:
"S0123ABCDEF"
"S0604QSJC"
include_countbooleanIf true, include the number of users in the User Group in the response.
Examples:
"true"
"false"
SLACK_EDIT_CANVASEdits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management.4 params
Edits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management.
Parameters* required
canvas_idstringThe unique identifier of the canvas to edit
Example: "F01234ABCDE"
operationstringType of edit operation: 'replace' (replaces entire canvas or specific section if section_id provided), 'insert_after' (inserts content after section_id), 'insert_before' (inserts content before section_id), 'insert_at_start' (prepends content to beginning), 'insert_at_end' (appends content to end), 'delete' (deletes specific section by section_id)one of
replace · insert_after · insert_before · insert_at_start · insert_at_end · deletedefault: replacesection_idstringSection ID for targeted operations. Required for: 'insert_after', 'insert_before', 'delete'. Optional for: 'replace' (if omitted, replaces entire canvas). Not used for: 'insert_at_start', 'insert_at_end'. Use canvases.sections.lookup method to get section IDs from existing canvas.
Examples:
"temp:C:VXX8e648e6984e441c6aa8c61173"
"section-abc-123"
document_contentvalueThe content to add/replace in Slack's document format. Required for all operations except 'delete'. Use canvases.sections.lookup to find section IDs for targeted operations.
Example: {"markdown":"# New Content\n\nContent here","type":"markdown"}
SLACK_ENABLE_A_SPECIFIED_USER_GROUPEnables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.2 params
Enables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.
Parameters* required
usergroupstringThe unique encoded ID of the User Group to enable. This ID typically starts with 'S'.
Example: "S0604QSJC"
include_countbooleanIf true, includes the count of users in the User Group in the response.
Examples:
"true"
"false"
SLACK_ENABLE_PUBLIC_SHARING_OF_A_FILEEnables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files.1 params
Enables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files.
Parameters* required
filestringThe ID of the file to be shared publicly.
Example: "F0123456789"
SLACK_END_A_CALL_WITH_DURATION_AND_IDEnds an ongoing Slack call, identified by its ID (obtained from `calls.add`), optionally specifying the call's duration.2 params
Ends an ongoing Slack call, identified by its ID (obtained from `calls.add`), optionally specifying the call's duration.
Parameters* required
idstringUnique identifier of the call to be ended, obtained from the `calls.add` method.
Example: "R0123456789"
durationintegerDuration of the call in seconds.
Examples:
"600"
"3600"
SLACK_END_SNOOZEEnds the current user's snooze mode immediately.
Ends the current user's snooze mode immediately.
No parameter schema in public metadata yet.
SLACK_END_USER_DO_NOT_DISTURB_SESSIONEnds the authenticated user's current Do Not Disturb (DND) session in Slack, affecting only DND status and making them available; if DND is not active, Slack acknowledges the request without changing status.
Ends the authenticated user's current Do Not Disturb (DND) session in Slack, affecting only DND status and making them available; if DND is not active, Slack acknowledges the request without changing status.
No parameter schema in public metadata yet.
SLACK_END_USER_SNOOZE_MODE_IMMEDIATELYDEPRECATED: Ends the current user's snooze mode immediately. Use `end_snooze` instead.
DEPRECATED: Ends the current user's snooze mode immediately. Use `end_snooze` instead.
No parameter schema in public metadata yet.
SLACK_FETCH_BOT_USER_INFORMATIONFetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types.1 params
Fetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types.
Parameters* required
botstringThe ID of the bot user to retrieve information for. This typically starts with 'B'.
Example: "B0123456789"
SLACK_FETCH_CONVERSATION_HISTORYFetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering.6 params
Fetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering.
Parameters* required
limitintegerMaximum number of messages to return per page (1-1000). Fewer may be returned if at the end of history or channel has fewer messages.
Examples:
"100"
"200"
cursorstringPagination cursor from `next_cursor` of a previous response to fetch subsequent pages. See Slack's pagination documentation for details.
Example: "dXNlcjpVMDYxTkZUVDA="
lateststringEnd of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., '1234567890.000000').
Example: "1609459200.000000"
oldeststringStart of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., '1234567890.000000').
Example: "1609372800.000000"
channelstringThe ID of the public channel, private channel, direct message, or multi-person direct message to fetch history from.
Examples:
"C1234567890"
"G0123456789"
"D0123456789"
inclusivebooleanInclude messages with `latest` or `oldest` timestamps in the results; applies only when `latest` or `oldest` is specified.
Examples:
"true"
"false"
SLACK_FETCH_CURRENT_TEAM_INFO_WITH_OPTIONAL_TEAM_SCOPEDEPRECATED: Fetches comprehensive metadata about the current Slack team. Use `fetch_team_info` instead.1 params
DEPRECATED: Fetches comprehensive metadata about the current Slack team. Use `fetch_team_info` instead.
Parameters* required
teamstringThe ID of the team to retrieve information for. If omitted, information for the current team (associated with the authentication token) is returned. The token must have permissions to view the specified team, especially for teams accessible via external shared channels.
Examples:
"T12345678"
"E87654321"
SLACK_FETCH_DND_STATUS_FOR_MULTIPLE_TEAM_MEMBERSDEPRECATED: Retrieves a user's current Do Not Disturb status. Use `get_team_dnd_status` instead.1 params
DEPRECATED: Retrieves a user's current Do Not Disturb status. Use `get_team_dnd_status` instead.
Parameters* required
usersstringComma-separated list of users to fetch Do Not Disturb status for
Example: "U1234,U5678"
SLACK_FETCH_ITEM_REACTIONSFetches reactions for a Slack message, file, or file comment, requiring one of: channel and timestamp; file ID; or file comment ID.5 params
Fetches reactions for a Slack message, file, or file comment, requiring one of: channel and timestamp; file ID; or file comment ID.
Parameters* required
filestringFile ID. Use instead of channel/timestamp or file comment ID.
Examples:
"F1234567890"
"F2147483002"
fullbooleanIf true, returns the complete list of users for each reaction.
channelstringChannel ID. Required if `timestamp` is provided and no file or file comment ID is given.
Examples:
"C1234567890"
"C061F7XAZ"
timestampstringMessage timestamp (e.g., '1234567890.123456'). Required if `channel` is provided and no file or file comment ID is given.
Examples:
"1234567890.123456"
"1629876543.000100"
file_commentstringFile comment ID. Use instead of channel/timestamp or file ID.
Examples:
"Fc1234567890"
"Fc789123456"
SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATIONRetrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message's timestamp (`ts`).7 params
Retrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message's timestamp (`ts`).
Parameters* required
tsstringTimestamp of the parent message in the thread. Must be an existing message. If no replies, only the parent message itself is returned.
Example: "1234567890.123456"
limitintegerMaximum number of messages to return. Fewer may be returned even if more are available.
Example: 100
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response to get subsequent pages. If omitted, fetches the first page.
Example: "dXNlcjpVMEc5V0ZYTlo="
lateststringLatest message timestamp in the time range to include results.
Example: "1678886400.000000"
oldeststringOldest message timestamp in the time range to include results.
Example: "1678836000.000000"
channelstringID of the conversation (channel, direct message, etc.) to fetch the thread from.
Example: "C0123456789"
inclusivebooleanWhether to include messages with `latest` or `oldest` timestamps in results. Effective only if `latest` or `oldest` is specified.
Example: true
SLACK_FETCH_TEAM_INFOFetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.1 params
Fetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.
Parameters* required
teamstringThe ID of the team to retrieve information for. If omitted, information for the current team (associated with the authentication token) is returned. The token must have permissions to view the specified team, especially for teams accessible via external shared channels.
Examples:
"T12345678"
"E87654321"
SLACK_FETCH_WORKSPACE_SETTINGS_INFORMATIONRetrieves detailed settings for a specific Slack workspace, primarily for administrators in an Enterprise Grid organization to view or audit workspace configurations.1 params
Retrieves detailed settings for a specific Slack workspace, primarily for administrators in an Enterprise Grid organization to view or audit workspace configurations.
Parameters* required
team_idstringThe unique identifier of the Slack team (workspace) for which to fetch settings. This ID typically starts with 'T'.
Example: "T12345ABCDE"
SLACK_FIND_CHANNELSFind channels in a Slack workspace by any criteria - name, topic, purpose, or description.6 params
Find channels in a Slack workspace by any criteria - name, topic, purpose, or description.
Parameters* required
limitintegerMaximum number of channels to return (1 to 200). Defaults to 50.
Examples:
10
25
100default: 50
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). Defaults to public and private channels.
Examples:
"public_channel"
"private_channel"
"public_channel,private_channel"default: public_channel,private_channel
exact_matchbooleanUse exact matching instead of partial matching. Defaults to false.
Examples:
true
falsedefault: false
member_onlybooleanOnly return channels the user is a member of. Defaults to false.
Examples:
true
falsedefault: false
search_querystringSearch query to find channels. Searches across channel name, topic, purpose, and description (case-insensitive partial matching).
Examples:
"general"
"marketing"
"dev"
"announcements"
"project"
exclude_archivedbooleanExclude archived channels from search results. Defaults to true.
Examples:
true
falsedefault: true
SLACK_FIND_USER_BY_EMAIL_ADDRESSRetrieves the Slack user object for an active user by their registered email address; fails with 'users_not_found' if the email is unregistered or the user is inactive.1 params
Retrieves the Slack user object for an active user by their registered email address; fails with 'users_not_found' if the email is unregistered or the user is inactive.
Parameters* required
emailstringThe email address of the user to look up.
Examples:
"sally.doe@example.com"
"johndoe@workplace.org"
SLACK_FIND_USERSFind users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches.6 params
Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches.
Parameters* required
limitintegerMaximum number of users to return (1 to 200). Defaults to 50.
Examples:
10
25
100default: 50
exact_matchbooleanUse exact matching instead of partial matching. Defaults to false.
Examples:
true
falsedefault: false
include_botsbooleanInclude bot users in search results. Defaults to false.
Examples:
true
falsedefault: false
search_querystringSearch query to find users. Searches across name, display name, real name, email address, first name, last name, and status text (case-insensitive partial matching). For exact email matches with exact_match=true, uses Slack's efficient email lookup endpoint.
Examples:
"john"
"john.doe@company.com"
"john doe"
"smith"
"@company.com"
include_deletedbooleanInclude deleted/deactivated users in search results. Defaults to false.
Examples:
true
falsedefault: false
include_restrictedbooleanInclude restricted (guest) users in search results. Defaults to true.
Examples:
true
falsedefault: true
SLACK_GET_CANVASRetrieves a specific Slack Canvas by its ID, including its content and metadata.1 params
Retrieves a specific Slack Canvas by its ID, including its content and metadata.
Parameters* required
canvas_idstringThe unique identifier of the canvas to retrieve
Example: "F01234ABCDE"
SLACK_GET_CHANNEL_CONVERSATION_PREFERENCESRetrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within Slack Enterprise Grid environments.1 params
Retrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within Slack Enterprise Grid environments.
Parameters* required
channel_idstringIdentifier of the channel for which to retrieve conversation preferences.
Example: "C0123456789"
SLACK_GET_REMINDER_INFORMATIONRetrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation.1 params
Retrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation.
Parameters* required
reminderstringThe unique identifier of the reminder to retrieve information for. This ID typically starts with 'Rm'.
Example: "Rm12345678"
SLACK_GET_REMOTE_FILERetrieve information about a remote file added to Slack.2 params
Retrieve information about a remote file added to Slack.
Parameters* required
filestringSpecify a file by providing its ID.
Example: "F2147483862"
external_idstringCreator defined GUID for the file.
Example: "123456"
SLACK_GET_TEAM_DND_STATUSRetrieves a user's current Do Not Disturb status.1 params
Retrieves a user's current Do Not Disturb status.
Parameters* required
usersstringComma-separated list of users to fetch Do Not Disturb status for
Example: "U1234,U5678"
SLACK_GET_USER_PRESENCE_INFORetrieves a Slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons.1 params
Retrieves a Slack user's current real-time presence (e.g., 'active', 'away') to determine their availability, noting this action does not provide historical data or status reasons.
Parameters* required
userstringThe ID of the user to query for presence information. This is a string identifier, typically starting with 'U' or 'W' (e.g., 'U123ABC456'). If not provided, presence information for the authenticated user will be returned.
Examples:
"U012A3CDE"
"W012A3CDE"
SLACK_INITIATES_CHANNEL_BASED_CONVERSATIONSDEPRECATED: Initiates a public or private channel-based conversation. Use `create_channel` instead.3 params
DEPRECATED: Initiates a public or private channel-based conversation. Use `create_channel` instead.
Parameters* required
namestringName of the public or private channel to create
Example: "mychannel"
team_idstringencoded team id to create the channel in, required if org token is used
Example: "T1234567890"
is_privatebooleanCreate a private channel instead of a public one
Example: true
SLACK_INVITE_USERS_TO_A_SLACK_CHANNELInvites users to an existing Slack channel using their valid Slack User IDs.2 params
Invites users to an existing Slack channel using their valid Slack User IDs.
Parameters* required
usersstringComma-separated string of valid Slack User IDs to invite. Up to 1000 user IDs can be included.
Example: "U1234567890,U2345678901,U3456789012"
channelstringID of the public or private Slack channel to invite users to; must be an existing channel. Typically starts with 'C' (public) or 'G' (private/group).
Examples:
"C1234567890"
"G0987654321"
SLACK_INVITE_USER_TO_CHANNELInvites users to a specified Slack channel; this action is restricted to Enterprise Grid workspaces and requires the authenticated user to be a member of the target channel.2 params
Invites users to a specified Slack channel; this action is restricted to Enterprise Grid workspaces and requires the authenticated user to be a member of the target channel.
Parameters* required
user_idsstringA comma-separated string of Slack User IDs to invite to the channel. Up to 1000 users can be specified.
Examples:
"U012A3CDE,U023B4DEF"
"W12345678,W87654321"
channel_idstringThe ID of the public or private Slack channel to which users will be invited.
Examples:
"C1234567890"
"C061X2Z7W9S"
SLACK_INVITE_USER_TO_WORKSPACEInvites a user to a Slack workspace and specified channels by email; use `resend=True` to re-process an existing invitation for a user not yet signed up.9 params
Invites a user to a Slack workspace and specified channels by email; use `resend=True` to re-process an existing invitation for a user not yet signed up.
Parameters* required
emailstringThe email address of the person to be invited to the workspace.
Example: "new.user@example.com"
resendbooleanIf true, allows this invitation to be resent if the user hasn't signed up. Defaults to false.
Examples:
"false"
"true"
team_idstringThe ID of the Slack workspace (e.g., T123ABCDEFG) where the user will be invited.
Example: "T123ABCDEFG"
real_namestringThe full name of the user being invited.
Example: "Jane Doe"
channel_idsstringA comma-separated list of channel IDs (e.g., C1234567890,C0987654321) for the user to join. At least one channel ID must be provided.
Examples:
"C1234567890,C9876543210"
"C0123456789"
is_restrictedbooleanSpecifies if the invited user should be a multi-channel guest. Defaults to false. Multi-channel guests can access only the channels they are invited to, plus any public channels.
Examples:
"false"
"true"
custom_messagestringCustom message to include in the invitation email.
Example: "Welcome to the team! Looking forward to working with you."
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
Example: "1678886400"
is_ultra_restrictedbooleanSpecifies if the invited user should be a single-channel guest (also known as an ultra-restricted guest). Defaults to false. Single-channel guests can only access one channel (plus DMs and Huddles).
Examples:
"false"
"true"
SLACK_INVITE_USER_TO_WORKSPACE_WITH_OPTIONAL_CHANNEL_INVITESDEPRECATED: Invites a user to a Slack workspace and specified channels by email. Use `invite_user_to_workspace` instead.9 params
DEPRECATED: Invites a user to a Slack workspace and specified channels by email. Use `invite_user_to_workspace` instead.
Parameters* required
emailstringThe email address of the person to be invited to the workspace.
Example: "new.user@example.com"
resendbooleanIf true, allows this invitation to be resent if the user hasn't signed up. Defaults to false.
Examples:
"false"
"true"
team_idstringThe ID of the Slack workspace (e.g., T123ABCDEFG) where the user will be invited.
Example: "T123ABCDEFG"
real_namestringThe full name of the user being invited.
Example: "Jane Doe"
channel_idsstringA comma-separated list of channel IDs (e.g., C1234567890,C0987654321) for the user to join. At least one channel ID must be provided.
Examples:
"C1234567890,C9876543210"
"C0123456789"
is_restrictedbooleanSpecifies if the invited user should be a multi-channel guest. Defaults to false. Multi-channel guests can access only the channels they are invited to, plus any public channels.
Examples:
"false"
"true"
custom_messagestringCustom message to include in the invitation email.
Example: "Welcome to the team! Looking forward to working with you."
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
Example: "1678886400"
is_ultra_restrictedbooleanSpecifies if the invited user should be a single-channel guest (also known as an ultra-restricted guest). Defaults to false. Single-channel guests can only access one channel (plus DMs and Huddles).
Examples:
"false"
"true"
SLACK_JOIN_AN_EXISTING_CONVERSATIONJoins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission.1 params
Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission.
Parameters* required
channelstringID of the Slack conversation (public channel, private channel, or multi-person direct message) to join.
Examples:
"C1234567890"
"G0987654321"
"D123ABCDEF0"
SLACK_LEAVE_A_CONVERSATIONLeaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel.1 params
Leaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel.
Parameters* required
channelstringID of the conversation to leave (e.g., C1234567890). Despite `default=None` in the schema, this ID is functionally required by the Slack API.
Examples:
"C1234567890"
"D9876543210"
"G12345ABCDE"
SLACK_LIST_ACCESSIBLE_CONVERSATIONS_FOR_A_USERDEPRECATED: Retrieves conversations accessible to a specified user. Use `list_conversations` instead.5 params
DEPRECATED: Retrieves conversations accessible to a specified user. Use `list_conversations` instead.
Parameters* required
userstringThe ID of the user whose conversations will be listed. If not provided, conversations for the authenticated user are returned. Non-public channels are restricted to those where the calling user (authenticating user) shares membership.
Examples:
"U123ABC456"
"W012A3BCD"
limitintegerThe maximum number of items to return per page. Must be an integer, typically between 1 and 1000 (e.g., 100). If omitted, the API's default limit (often 100) applies. Fewer items than the limit may be returned.
Examples:
"100"
"500"
"1000"
typesstringA comma-separated list of conversation types to include. Valid types are `public_channel`, `private_channel`, `mpim` (multi-person direct message), and `im` (direct message). If omitted, all types are included.
Examples:
"public_channel,private_channel"
"im,mpim"
"public_channel"
cursorstringPagination cursor for retrieving the next set of results. Obtain this from the `next_cursor` field in a previous response's `response_metadata`. If omitted, the first page is fetched.
Examples:
"dXNlcjpVMDYxREk0Nlc="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQz"
exclude_archivedbooleanSet to `true` to exclude archived channels from the list. If `false` or omitted, archived channels are typically included (the API's default behavior for omission will apply, usually including them).
Examples:
"true"
"false"
SLACK_LIST_ALL_CHANNELSLists conversations available to the user with various filters and search options.5 params
Lists conversations available to the user with various filters and search options.
Parameters* required
limitintegerMaximum number of channels to return per page (1 to 1000). Fewer channels may be returned than requested. This schema defaults to 1 if omitted.
Examples:
100
500
1000default: 1
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). The API defaults to `public_channel` if this parameter is omitted.
Examples:
"public_channel,private_channel"
"im,mpim"
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
Examples:
"dXNlcjpVMDYxTkZUVDI="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQ5"
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
Examples:
"general"
"announcements"
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Examples:
true
false
SLACK_LIST_ALL_SLACK_TEAM_CHANNELS_WITH_VARIOUS_FILTERSDEPRECATED: Lists conversations available to the user with various filters and search options. Use `list_channels` instead.5 params
DEPRECATED: Lists conversations available to the user with various filters and search options. Use `list_channels` instead.
Parameters* required
limitintegerMaximum number of channels to return per page (1 to 1000). Fewer channels may be returned than requested. This schema defaults to 1 if omitted.
Examples:
100
500
1000default: 1
typesstringComma-separated list of channel types to include: `public_channel`, `private_channel`, `mpim` (multi-person direct message), `im` (direct message). The API defaults to `public_channel` if this parameter is omitted.
Examples:
"public_channel,private_channel"
"im,mpim"
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
Examples:
"dXNlcjpVMDYxTkZUVDI="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQ5"
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
Examples:
"general"
"announcements"
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Examples:
true
false
SLACK_LIST_ALL_SLACK_TEAM_USERS_WITH_PAGINATIONDEPRECATED: Retrieves a paginated list of all users in a Slack workspace. Use `list_all_users` instead.3 params
DEPRECATED: Retrieves a paginated list of all users in a Slack workspace. Use `list_all_users` instead.
Parameters* required
limitintegerMaximum number of items to return per page; fewer may be returned if the end of the list is reached. Recommended to set a value (e.g., 100) as Slack may error for large workspaces if omitted.
Examples:
"20"
"100"
"200"default: 1
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"dXNlcjpVMDYxREk0STQ="
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Examples:
"true"
"false"
SLACK_LIST_ALL_USERSRetrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a Slack workspace; data may not be real-time.3 params
Retrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a Slack workspace; data may not be real-time.
Parameters* required
limitintegerMaximum number of items to return per page; fewer may be returned if the end of the list is reached. Recommended to set a value (e.g., 100) as Slack may error for large workspaces if omitted.
Examples:
"20"
"100"
"200"default: 1
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"dXNlcjpVMDYxREk0STQ="
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Examples:
"true"
"false"
SLACK_LIST_ALL_USERS_IN_A_USER_GROUPRetrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups.2 params
Retrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups.
Parameters* required
usergroupstringThe encoded ID of the User Group to list users from. This ID is an alphanumeric string.
Examples:
"S0604QSJC"
"S123ABC456"
include_disabledbooleanSet to `true` to include users from disabled user groups. If omitted, the default Slack API behavior for handling disabled groups (typically excluding them) will apply.
SLACK_LIST_CANVASESLists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter.6 params
Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter.
Parameters* required
pageintegerPage number for pagination (1-based)default: 1
userstringOptional user ID to filter canvases created by a specific user.
Example: "U1234567890"
countintegerMaximum number of canvases to return per page (1-1000)default: 100
ts_tostringFilter canvases created before this timestamp (inclusive). Unix timestamp as string.
Example: "123456789"
channelstringOptional channel ID (e.g., 'C1234567890') to filter canvases. Must be a channel ID, not name.
Examples:
"C1234567890"
"C9876543210"
ts_fromstringFilter canvases created after this timestamp (inclusive). Unix timestamp as string.
Example: "123456789"
SLACK_LIST_CONVERSATIONSList conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels.5 params
List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels.
Parameters* required
userstringThe ID of the user whose conversations will be listed. If not provided, conversations for the authenticated user are returned. Non-public channels are restricted to those where the calling user (authenticating user) shares membership.
Examples:
"U123ABC456"
"W012A3BCD"
limitintegerThe maximum number of items to return per page. Must be an integer, typically between 1 and 1000 (e.g., 100). If omitted, the API's default limit (often 100) applies. Fewer items than the limit may be returned.
Examples:
"100"
"500"
"1000"
typesstringA comma-separated list of conversation types to include. Valid types are `public_channel`, `private_channel`, `mpim` (multi-person direct message), and `im` (direct message). If omitted, all types are included.
Examples:
"public_channel,private_channel"
"im,mpim"
"public_channel"
cursorstringPagination cursor for retrieving the next set of results. Obtain this from the `next_cursor` field in a previous response's `response_metadata`. If omitted, the first page is fetched.
Examples:
"dXNlcjpVMDYxREk0Nlc="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQz"
exclude_archivedbooleanSet to `true` to exclude archived channels from the list. If `false` or omitted, archived channels are typically included (the API's default behavior for omission will apply, usually including them).
Examples:
"true"
"false"
SLACK_LIST_FILES_WITH_FILTERS_IN_SLACKLists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.8 params
Lists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.
Parameters* required
pagestringSpecifies the page number of the results to retrieve when paginating. Default is 1.
Examples:
"1"
"2"
userstringFilter files created by a single user. Provide the Slack User ID.
Examples:
"W1234567890"
"U0abcdef0"
countstringSpecifies the number of files to return per page. Default is 100, maximum is 1000.
Examples:
"100"
"50"
"1000"
ts_tointegerFilter files created before this Unix timestamp (inclusive).
Example: "1678972800"
typesstringFilter files by types (comma-separated: 'images,pdfs'). Default 'all' for all types. Common: `all`, `spaces` (posts), `snippets`, `images`, `gdocs`, `zips`, `pdfs`.
Examples:
"images"
"pdfs"
"images,pdfs"
"all"
"spaces,snippets"
channelstringFilter files appearing in a specific channel, indicated by its Slack Channel ID.
Examples:
"C1234567890"
"G0abcdef0"
ts_fromintegerFilter files created after this Unix timestamp (inclusive).
Example: "1678886400"
show_files_hidden_by_limitbooleanShow truncated file info for files hidden due to being too old or if the team owning the file is over the storage limit.
Examples:
true
false
SLACK_LIST_REMINDERSLists all reminders with their details for the authenticated Slack user; returns an empty list if no reminders exist.
Lists all reminders with their details for the authenticated Slack user; returns an empty list if no reminders exist.
No parameter schema in public metadata yet.
SLACK_LIST_REMOTE_FILESRetrieve information about a team's remote files.5 params
Retrieve information about a team's remote files.
Parameters* required
limitintegerThe maximum number of items to return.
Example: 20
ts_tonumberFilter files created before this timestamp (inclusive).
Example: 123456789.012345
cursorstringPaginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail.
Example: "dXNlcjpVMDYxTkZUVDI="
channelstringFilter files appearing in a specific channel, indicated by its ID.
Example: "C1234567890"
ts_fromnumberFilter files created after this timestamp (inclusive).
Example: 123456789.012345
SLACK_LIST_SCHEDULED_MESSAGESRetrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel, or across all accessible channels if no channel ID is provided, optionally filtered by time and paginated.5 params
Retrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel, or across all accessible channels if no channel ID is provided, optionally filtered by time and paginated.
Parameters* required
limitintegerMaximum messages per page (1-1000). Defaults to 100.
Examples:
"100"
"50"
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"bmV4dF9wYWdlX2N1cnNvcg=="
lateststringLatest UNIX timestamp (exclusive) for messages. Defaults to the current time if omitted.
Examples:
"1678886400.000000"
"1678972800.000000"
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
Examples:
"1678800000.000000"
"1678880000.000000"
channelstringID or name of the channel (public, private, or DM) to list messages for. If omitted, lists for all accessible channels in the workspace.
Examples:
"C1234567890"
"general"
SLACK_LIST_SCHEDULED_MESSAGES_IN_A_CHANNELDEPRECATED: Retrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel. Use `list_scheduled_messages` instead.5 params
DEPRECATED: Retrieves a list of pending (not yet delivered) messages scheduled in a specific Slack channel. Use `list_scheduled_messages` instead.
Parameters* required
limitintegerMaximum messages per page (1-1000). Defaults to 100.
Examples:
"100"
"50"
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"bmV4dF9wYWdlX2N1cnNvcg=="
lateststringLatest UNIX timestamp (exclusive) for messages. Defaults to the current time if omitted.
Examples:
"1678886400.000000"
"1678972800.000000"
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
Examples:
"1678800000.000000"
"1678880000.000000"
channelstringID or name of the channel (public, private, or DM) to list messages for. If omitted, lists for all accessible channels in the workspace.
Examples:
"C1234567890"
"general"
SLACK_LIST_SLACK_S_REMOTE_FILES_WITH_FILTERSDEPRECATED: Retrieve information about a team's remote files. Use `list_remote_files` instead.5 params
DEPRECATED: Retrieve information about a team's remote files. Use `list_remote_files` instead.
Parameters* required
limitintegerThe maximum number of items to return.
Example: 20
ts_tonumberFilter files created before this timestamp (inclusive).
Example: 123456789.012345
cursorstringPaginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail.
Example: "dXNlcjpVMDYxTkZUVDI="
channelstringFilter files appearing in a specific channel, indicated by its ID.
Example: "C1234567890"
ts_fromnumberFilter files created after this timestamp (inclusive).
Example: 123456789.012345
SLACK_LISTS_PINNED_ITEMS_IN_A_CHANNELRetrieves all messages and files pinned to a specified channel; the caller must have access to this channel.1 params
Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel.
Parameters* required
channelstringThe ID of the channel to retrieve pinned items from. This can be a public channel ID, private group ID, or direct message channel ID.
Examples:
"C1234567890"
"G0123456789"
"D0123456789"
SLACK_LIST_STARRED_ITEMSLists items starred by a user.4 params
Lists items starred by a user.
Parameters* required
pagevaluePage number of results to return.
Example: 2
countvalueNumber of items to return per page.
Example: 20
limitvalueThe maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
Example: 20
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Example: "dXNlcjpVMDYxTkZUVDI="
SLACK_LISTS_USER_S_STARRED_ITEMS_WITH_PAGINATIONDEPRECATED: Lists items starred by a user. Use `list_starred_items` instead.4 params
DEPRECATED: Lists items starred by a user. Use `list_starred_items` instead.
Parameters* required
pagevaluePage number of results to return.
Example: 2
countvalueNumber of items to return per page.
Example: 20
limitvalueThe maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
Example: 20
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Example: "dXNlcjpVMDYxTkZUVDI="
SLACK_LIST_TEAM_CUSTOM_EMOJISRetrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates.
Retrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates.
No parameter schema in public metadata yet.
SLACK_LIST_USER_GROUPS_FOR_TEAM_WITH_OPTIONSLists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated.3 params
Lists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated.
Parameters* required
include_countbooleanInclude the number of users in each user group. Defaults to false.
Examples:
"true"
"false"
include_usersbooleanInclude the list of user IDs for each user group. Defaults to false.
Examples:
"true"
"false"
include_disabledbooleanInclude disabled user groups in the results. Defaults to false.
Examples:
"true"
"false"
SLACK_LIST_USER_REACTIONSLists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required.6 params
Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required.
Parameters* required
fullbooleanIf true, return the complete reaction list, which may include reactions to deleted items.
pageintegerPage number of results to return.
Example: "1"
userstringReactions made by this user. Defaults to the authed user.
Example: "U012A3CDEFG"
countintegerNumber of items to return per page.
Example: "20"
limitintegerMaximum number of items to return; fewer items may be returned. Use with cursor-based pagination.
Example: "100"
cursorstringPagination cursor. Set to `next_cursor` from a previous response's `response_metadata`. See Slack API pagination documentation for details.
Example: "dXNlcjpVMDYxTkZ0NUI="
mcp-slack-crunchtools
Secure read-only MCP server for Slack workspaces. Provides Claude Code (and other MCP clients) with access to your Slack channels, messages, users, and files without any write permissions.
Features
- Read-only: 15 tools, all read-only. Never posts, edits, or deletes anything.
- Secure: 6-layer security model (input validation, token handling, client hardening, output sanitization, runtime protection, supply chain security).
- User OAuth Token: Uses
xoxp-tokens for user-scoped access to your workspace. - No SDK dependency: Uses
httpxdirectly for minimal, auditable HTTP calls.
Quick Start
Using uvx (Recommended)
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- uvx mcp-slack-crunchtools
Using Container
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- podman run -i --rm -e SLACK_USER_TOKEN quay.io/crunchtools/mcp-slack
Local Development
claude mcp add mcp-slack-crunchtools \
--env SLACK_USER_TOKEN=xoxp-your-token \
-- uv run mcp-slack-crunchtools
Setup
See CLAUDE.md for detailed instructions on creating a Slack app and obtaining a User OAuth Token.
Tools
| Tool | Description |
|---|---|
slack_auth_test | Test connection and get token owner info |
slack_list_channels | List workspace channels |
slack_get_channel_info | Get channel details |
slack_get_channel_history | Read channel messages |
slack_get_thread_replies | Read thread replies |
slack_list_channel_members | List channel members |
slack_search_messages | Search messages |
slack_get_reactions | Get message reactions |
slack_list_reactions | List user's reactions |
slack_list_stars | List starred items |
slack_get_user_info | Get user details |
slack_list_users | List workspace members |
slack_get_user_profile | Get user profile |
slack_list_files | List files (metadata only) |
slack_get_file_info | Get file metadata |
Security
See SECURITY.md for the full security design document.
License
AGPL-3.0-or-later
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Packagemcp-slack-crunchtools
TransportSTDIO
UpdatedMar 25, 2026
