Summary
Gives your AI assistant direct Slack access using browser session tokens instead of OAuth, sidestepping app registration and admin approval entirely. Exposes 21 tools including conversation history, search, thread retrieval, message sending, reactions, and mark-as-read. Newer workflow primitives let you save profiles that bind channels to structured output formats like incident summaries or support triage queues, with a hosted brain service that returns parseable JSON for downstream automation. Works with Claude Desktop, Cursor, Windsurf, and Gemini CLI out of the box. The session token approach means no bot user appears in workspace admin panels. Setup takes two minutes via npx, and the token refresh tool pulls fresh credentials directly from Chrome's local database.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →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
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 pr...
tokenstringAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
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...
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
alias_forstringThe canonical name of the existing custom emoji (e.g., `original_emoji`).
Examples:
"party_parrot"
"approved_stamp"
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...
tokenstringAuthentication token. Requires the `admin.teams:write` scope.
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
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/file...
filetypestringFile type (e.g., 'pdf', 'docx', 'png') to help Slack display appropriate icons or previews.
Examples:
"pdf"
"docx"
"gdoc"
"png"
"txt"
"gsheet"
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 fr...
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)"
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"
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
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"
filestringID of the file to add a star to.
Examples:
"F1234567890"
"F0987654321"
file_commentstringID of the file comment to add a star to.
Examples:
"Fc1234567890"
"Fc0987654321"
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...
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 optionall...
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
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 pr...
tokenstringAuthentication token used to authorize the request to add a custom emoji to the Slack workspace.
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...
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
channelstringID of the channel where the message to add the reaction to was posted.
Examples:
"C1234567890"
"G0987654321"
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.,...
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:
"12345...
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
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 appear...
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%20...
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%22...
channelstringID or name of the channel, private group, or IM channel to send the message to.
Examples:
"C1234567890"
"general"
icon_emojistringEmoji for bot's icon (e.g., ':robot_face:'). Overrides `icon_url`. Applies if `as_user` is `false`.
Examples:
":tada:"
":slack:"
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"
link_namesbooleanAutomatically hyperlink channel names (e.g., #channel) and usernames (e.g., @user) in message text. Defaults to `false` for bot messages.
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 (...
mrkdwnbooleanDisable Slack's markdown for `text` field if `false`. Default `true` (allows *bold*, _italic_, etc.).
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"
reply_broadcastbooleanIf `true` for a threaded reply, also posts to main channel. Defaults to `false`.
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...
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"
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`.
usernamestringBot's name in Slack (max 80 chars). Applies if `as_user` is `false`.
Examples:
"MyBot"
"AlertBot"
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...
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
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."
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"
"proj...
include_countbooleanInclude the User Group's user count in the response. Server defaults to `false` if omitted.
namestringUnique name for the User Group. Must be unique among all User Groups in the workspace.
Examples:
"Customer Support"
"Core Engineering"
"Project Phoenix Leads"
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
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"}
titlestringThe title of the canvas to create
Examples:
"Project Planning"
"Team Meeting Notes"
"Sprint Retrospective"
SLACK_CREATE_CHANNELInitiates a public or private channel-based conversation3 params
Initiates a public or private channel-based conversation
Parameters* required
is_privatebooleanCreate a private channel instead of a public one
Example: true
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"
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
descriptionstringOptional description for the channel (e.g., 'Discussion about Q4 marketing strategies').
is_privatebooleanSet to `true` to make the channel private, or `false` for public.
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-campa...
org_widebooleanSet to `true` to make the channel available org-wide. If `false` or not set, `team_id` is required.
team_idstringWorkspace (team) ID for channel creation (e.g., T123ABCDEFG). Required if `org_wide` is `false` or not set.
Example: "T123ABCDEFG"
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
channelstringChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
Examples:
"C1234567890"
"general"
tsstringTimestamp of the message to customize URL unfurling for.
Example: "1234567890.123456"
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%22h...
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...
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
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"
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
channelstringChannel, private group, or DM channel to send message to. Can be an encoded ID, or a name.
Examples:
"C1234567890"
"general"
tsstringTimestamp of the message to customize URL unfurling for.
Example: "1234567890.123456"
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%22h...
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...
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
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"
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
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"
idstringID of the comment to delete. This can be obtained when the comment is created or by listing file comments.
Example: "Fc1234567890"
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` sco...
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
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 `ch...
channelstringThe ID of the channel, private group, or direct message conversation containing the message to be deleted.
Examples:
"C1234567890"
"G0987654321"
"D060123ABC"
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"
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
include_countbooleanIf true, include the number of users in the User Group in the response.
Examples:
"true"
"false"
usergroupstringUnique encoded ID of the User Group to disable.
Examples:
"S0123ABCDEF"
"S0604QSJC"
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"
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":"#...
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 sec...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_a...
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
include_countbooleanIf true, includes the count of users in the User Group in the response.
Examples:
"true"
"false"
usergroupstringThe unique encoded ID of the User Group to enable. This ID typically starts with 'S'.
Example: "S0604QSJC"
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
durationintegerDuration of the call in seconds.
Examples:
"600"
"3600"
idstringUnique identifier of the call to be ended, obtained from the `calls.add` method.
Example: "R0123456789"
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
channelstringThe ID of the public channel, private channel, direct message, or multi-person direct message to fetch history from.
Examples:
"C1234567890"
"G0123456789"
"D0123456789"
cursorstringPagination cursor from `next_cursor` of a previous response to fetch subsequent pages. See Slack's pagination documentation for details.
Example: "dXNlcjpVMDYxTkZUVDA="
inclusivebooleanInclude messages with `latest` or `oldest` timestamps in the results; applies only when `latest` or `oldest` is specified.
Examples:
"true"
"false"
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"
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"
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"
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 spec...
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
channelstringChannel ID. Required if `timestamp` is provided and no file or file comment ID is given.
Examples:
"C1234567890"
"C061F7XAZ"
filestringFile ID. Use instead of channel/timestamp or file comment ID.
Examples:
"F1234567890"
"F2147483002"
file_commentstringFile comment ID. Use instead of channel/timestamp or file ID.
Examples:
"Fc1234567890"
"Fc789123456"
fullbooleanIf true, returns the complete list of users for each reaction.
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"
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
channelstringID of the conversation (channel, direct message, etc.) to fetch the thread from.
Example: "C0123456789"
cursorstringPagination cursor from `response_metadata.next_cursor` of a previous response to get subsequent pages. If omitted, fetches the first page.
Example: "dXNlcjpVMEc5V0ZYTlo="
inclusivebooleanWhether to include messages with `latest` or `oldest` timestamps in results. Effective only if `latest` or `oldest` is specified.
Example: true
lateststringLatest message timestamp in the time range to include results.
Example: "1678886400.000000"
limitintegerMaximum number of messages to return. Fewer may be returned even if more are available.
Example: 100
oldeststringOldest message timestamp in the time range to include results.
Example: "1678836000.000000"
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"
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 spec...
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
exact_matchbooleanUse exact matching instead of partial matching. Defaults to false.
Examples:
true
falsedefault: false
exclude_archivedbooleanExclude archived channels from search results. Defaults to true.
Examples:
true
falsedefault: true
limitintegerMaximum number of channels to return (1 to 200). Defaults to 50.
Examples:
10
25
100default: 50
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"
"pr...
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...default: public_channel,private_channel
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
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
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
limitintegerMaximum number of users to return (1 to 200). Defaults to 50.
Examples:
10
25
100default: 50
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 ex...
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
external_idstringCreator defined GUID for the file.
Example: "123456"
filestringSpecify a file by providing its ID.
Example: "F2147483862"
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 authenticat...
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
is_privatebooleanCreate a private channel instead of a public one
Example: true
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"
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
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"
usersstringComma-separated string of valid Slack User IDs to invite. Up to 1000 user IDs can be included.
Example: "U1234567890,U2345678901,U3456789012"
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
channel_idstringThe ID of the public or private Slack channel to which users will be invited.
Examples:
"C1234567890"
"C061X2Z7W9S"
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"
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
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"
custom_messagestringCustom message to include in the invitation email.
Example: "Welcome to the team! Looking forward to working with you."
emailstringThe email address of the person to be invited to the workspace.
Example: "new.user@example.com"
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
Example: "1678886400"
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...
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)...
real_namestringThe full name of the user being invited.
Example: "Jane Doe"
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"
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
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"
custom_messagestringCustom message to include in the invitation email.
Example: "Welcome to the team! Looking forward to working with you."
emailstringThe email address of the person to be invited to the workspace.
Example: "new.user@example.com"
guest_expiration_tsstringUnix timestamp for guest account expiration; provide only if inviting a guest user and an expiration date is desired.
Example: "1678886400"
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...
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)...
real_namestringThe full name of the user being invited.
Example: "Jane Doe"
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"
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
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:
"...
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...
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...
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...
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 (au...
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
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
Examples:
"general"
"announcements"
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
Examples:
"dXNlcjpVMDYxTkZUVDI="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQ5"
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Examples:
true
false
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 para...
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
channel_namestringFilter channels by name (case-insensitive substring match). This is a client-side filter applied after fetching from the API.
Examples:
"general"
"announcements"
cursorstringPagination cursor (from a previous response's `next_cursor`) for the next page of results. Omit for the first page.
Examples:
"dXNlcjpVMDYxTkZUVDI="
"bmV4dF90czoxNTEyMDg1ODYxMDAwNTQ5"
exclude_archivedbooleanExcludes archived channels if true. The API defaults to false (archived channels are included).
Examples:
true
false
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 para...
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
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"dXNlcjpVMDYxREk0...
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Examples:
"true"
"false"
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.
Examp...default: 1
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
cursorstringPagination cursor for fetching subsequent pages. Set to `next_cursor` from a previous response's `response_metadata`. Omit for the first page.
Examples:
"dXNlcjpVMDYxREk0STM="
"dXNlcjpVMDYxREk0...
include_localebooleanInclude the `locale` field for each user. Defaults to `false`.
Examples:
"true"
"false"
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.
Examp...default: 1
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
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.
usergroupstringThe encoded ID of the User Group to list users from. This ID is an alphanumeric string.
Examples:
"S0604QSJC"
"S123ABC456"
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
channelstringOptional channel ID (e.g., 'C1234567890') to filter canvases. Must be a channel ID, not name.
Examples:
"C1234567890"
"C9876543210"
countintegerMaximum number of canvases to return per page (1-1000)default: 100
pageintegerPage number for pagination (1-based)default: 1
ts_fromstringFilter canvases created after this timestamp (inclusive). Unix timestamp as string.
Example: "123456789"
ts_tostringFilter canvases created before this timestamp (inclusive). Unix timestamp as string.
Example: "123456789"
userstringOptional user ID to filter canvases created by a specific user.
Example: "U1234567890"
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
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:
"...
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...
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...
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...
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 (au...
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
channelstringFilter files appearing in a specific channel, indicated by its Slack Channel ID.
Examples:
"C1234567890"
"G0abcdef0"
countstringSpecifies the number of files to return per page. Default is 100, maximum is 1000.
Examples:
"100"
"50"
"1000"
pagestringSpecifies the page number of the results to retrieve when paginating. Default is 1.
Examples:
"1"
"2"
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
ts_fromintegerFilter files created after this Unix timestamp (inclusive).
Example: "1678886400"
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"...
userstringFilter files created by a single user. Provide the Slack User ID.
Examples:
"W1234567890"
"U0abcdef0"
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
channelstringFilter files appearing in a specific channel, indicated by its ID.
Example: "C1234567890"
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 col...
limitintegerThe maximum number of items to return.
Example: 20
ts_fromnumberFilter files created after this timestamp (inclusive).
Example: 123456789.012345
ts_tonumberFilter files created before 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
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"
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"
limitintegerMaximum messages per page (1-1000). Defaults to 100.
Examples:
"100"
"50"
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
Examples:
"1678800000.000000"
"1678880000.000000"
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
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"
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"
limitintegerMaximum messages per page (1-1000). Defaults to 100.
Examples:
"100"
"50"
oldeststringEarliest UNIX timestamp (inclusive) for messages. Defaults to 0 if omitted.
Examples:
"1678800000.000000"
"1678880000.000000"
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
channelstringFilter files appearing in a specific channel, indicated by its ID.
Example: "C1234567890"
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 col...
limitintegerThe maximum number of items to return.
Example: 20
ts_fromnumberFilter files created after this timestamp (inclusive).
Example: 123456789.012345
ts_tonumberFilter files created before 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
countvalueNumber of items to return per page.
Example: 20
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Example: "dXNlcjpVMDYxTkZUVDI="
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
pagevaluePage number of results to return.
Example: 2
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
countvalueNumber of items to return per page.
Example: 20
cursorstringParameter for pagination. Set cursor to the next_cursor attribute returned by the previous request's response_metadata.
Example: "dXNlcjpVMDYxTkZUVDI="
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
pagevaluePage number of results to return.
Example: 2
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_disabledbooleanInclude disabled user groups in the results. Defaults to false.
Examples:
"true"
"false"
include_usersbooleanInclude the list of user IDs for each user group. 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
countintegerNumber of items to return per page.
Example: "20"
cursorstringPagination cursor. Set to `next_cursor` from a previous response's `response_metadata`. See Slack API pagination documentation for details.
Example: "dXNlcjpVMDYxTkZ0NUI="
fullbooleanIf true, return the complete reaction list, which may include reactions to deleted items.
limitintegerMaximum number of items to return; fewer items may be returned. Use with cursor-based pagination.
Example: "100"
pageintegerPage number of results to return.
Example: "1"
userstringReactions made by this user. Defaults to the authed user.
Example: "U012A3CDEFG"
Slack MCP Server
Catch up on Slack without reading it.
Unreads, threads, and search — in your agent’s context, from the session you already have.
Set it up, then register it with your client.
npx -y @jtalk22/slack-mcp --setup
claude mcp add slack -- npx -y @jtalk22/slack-mcp
Check where your credentials are stored and how old they are, or run it read-only so your agent can read Slack but never post.
npx -y @jtalk22/slack-mcp --doctor --security
npx -y @jtalk22/slack-mcp --read-only
On Enterprise Grid, Slack can end a session it sees being automated. Use Slack's official MCP server there.
Claude Code Claude Desktop Cursor Copilot Windsurf Gemini CLI Codex CLI any stdio MCP client
What’s new in 5.1 · ▶ the whole morning in three minutes · interactive walkthrough · setup guide
If your workspace is on Slack's free plan
Checked against Slack's published plans and pricing on 2026-10-07.
A free workspace keeps 90 days of message history, allows 10 app integrations, and gets only Slack's basic AI. The AI people actually want — AI search across the workspace, channel recaps, Slackbot acting as an agent, AI workflow generation — starts on Business+ at $15 per user per month on annual billing ($18 month to month). Pro, at $7.25, buys unlimited history and unlimited apps, not the advanced AI. So a ten-person free workspace that wants an AI it can ask about its own Slack is looking at $1,800 a year, and the cheaper upgrade does not get them there.
This package gives that workspace an agent over the same Slack for nothing, running on the AI subscription its people already pay for. Three things follow from how it works:
- It installs no Slack app, so it uses none of your 10 app slots. If your workspace is already at the cap, this is the only way left to add an integration at all.
- It needs no admin approval, because it is not an app anyone has to approve. It reads Slack through your own browser session, with exactly the access you already have and nothing more.
- It can export what you can still see. On a free plan, history older than 90 days stops being reachable — Slack's own free export covers public channels only and is admin-only, so DMs and private channels are not in it.
slack_get_full_conversationwrites them out with their threads while they are still inside the window. It cannot retrieve anything already past the line; nothing can.
The browser-session route is not a workaround to apologise for. For a workspace Slack's own AI does not serve, it is the only route there is.
Two ways into Slack
Slack's official MCP server is an app your workspace admin approves and controls. Use it when your organisation wants a sanctioned integration. This server uses the browser session already in Chrome instead, so there is no app to install and no admin to ask, and it runs as a local command for any stdio MCP client. It acts as you, with exactly your access.
Side by side: the managed integration path vs. the local session path
| Slack official MCP | Slack MCP Server — local | |
|---|---|---|
| Starting point | A Slack-managed remote integration | The Slack session already in Chrome |
| Workspace control | Governed by workspace integration settings | No Slack app or admin request for the local path |
| Transport | Streamable HTTP | Local stdio |
| Client surface | Slack's supported partner integrations | Any stdio MCP client |
| Authentication | OAuth | Existing browser session |
| Credential lifetime | Managed OAuth | Rotating session with health checks and refresh |
| Product surface | Broad Slack-native capabilities | 20 tools across read, act, and automate |
| Protocol | Slack-managed | MCP 2026-07-28 and every 2025 revision, from the same binary |
| Runtime | Slack-managed | MIT code on your machine |
Is the local path against Slack's terms?
Treat browser-session automation as an acceptable-use decision for you and your workspace. The server acts as your signed-in Slack identity and cannot read a channel you cannot read or act as another user. It does not evade server-side retention, DLP, compliance exports, or audit controls.
"No admin request" means there is no Slack app installation to approve. It does not mean workspace activity disappears from Slack's systems. If your policy requires a sanctioned integration, use Slack's official MCP server.
Install
Node 22 or 24 recommended. Node 20+ is supported and CI-tested.
npx -y @jtalk22/slack-mcp --setup
Prefer a persistent CLI: npm install -g @jtalk22/slack-mcp then slack-mcp --setup.
Then:
- Copy the stdio command
--setupprints when it finishes. - Paste it into your client, or run the
claude mcp addline it prints. - Fully restart the client.
- Ask the agent to run
slack_health_check. - A workspace name in the response means the connection is live.
Per-client configuration keys are in the setup guide.
Use the same server command everywhere:
{
"command": "npx",
"args": ["-y", "@jtalk22/slack-mcp"]
}
On macOS, setup can extract from Chrome and persist the selected storage backend. On other platforms, provide SLACK_TOKEN and SLACK_COOKIE through the client's environment configuration. Docker, HTTP, and detailed client examples live in docs/SETUP.md and docs/DEPLOYMENT-MODES.md.
Client configuration matrix
| Client | Configuration surface | Status |
|---|---|---|
| Claude Code | claude mcp add or ~/.claude.json | Documented |
| Claude Desktop | Desktop MCP configuration | Verified |
| Cursor | .cursor/mcp.json | Documented |
| GitHub Copilot | .vscode/mcp.json | Documented |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | Documented |
| Gemini CLI | ~/.gemini/settings.json | Documented |
| Codex CLI | codex mcp add or ~/.codex/config.toml | Documented |
| Other clients | Any stdio MCP configuration | Protocol-compatible |
20 tools: read, act, automate
Read channels, DMs, threads and search; act with a reply, a reaction or a read-state change; run the catch-up and typed workflows locally. The surface is 20 tools today: 13 read-only operations, 4 write-path tools that each carry an MCP destructive annotation so clients can gate workspace writes, and 3 local workflow tools. One of the reads is slack_session_report, which reads nothing from Slack: it returns what this process has done, as counts. Every tool does its work here — reads Slack or local state — and none is a placeholder for something you would have to pay for. Four read tools accept include_rich_message_fields: true to surface attachments, blocks, files, reactions, and metadata—complete inputs and response contracts live in docs/API.md.
Speaks MCP 2026-07-28 and every 2025 revision from the same binary — era-negotiated over stdio, stateless per request over HTTP (no Mcp-Session-Id; GET/DELETE answer 405). The claim is a test, not a sentence: test/mcp-era.test.js drives the real SDK client at both eras against the real entry points.
Advertising fewer tools. Every tool the server advertises sends its schema to the model on every turn, before you ask anything. SLACK_MCP_TOOLS=essentials advertises six (unread, history, search, thread, user lookup, send); SLACK_MCP_TOOLS=read the 13 read-only operations; --tools=slack_x,slack_y an explicit set. The default is all 20. Filtering changes what is advertised, not what is callable.
The full tool inventory
13 read-only operations
| Tool | Purpose |
|---|---|
slack_health_check | Verify credentials and workspace identity |
slack_token_status | Inspect credential age, health, cache, profile, and storage state |
slack_refresh_tokens | Refresh local credentials from the browser session on macOS—reads Slack, writes only local state |
slack_list_conversations | List channels and DMs |
slack_conversations_history | Read channel or DM history with optional rich fields |
slack_get_full_conversation | Export complete history and threads |
slack_search_messages | Search across the workspace |
slack_get_thread | Read all replies in a thread |
slack_users_info | Resolve a user |
slack_list_users | Page through large workspace directories |
slack_users_search | Search users by name, display name, or email |
slack_conversations_unreads | Prioritize conversations with unread messages |
Act in the workspace — 4 write-path tools
| Tool | Purpose | MCP safety |
|---|---|---|
slack_send_message | Send to a channel or DM | destructive |
slack_add_reaction | Add an emoji reaction | destructive |
slack_remove_reaction | Remove an emoji reaction | destructive |
slack_conversations_mark | Mark a conversation read | destructive |
Automate locally — 3 workflow tools
| Tool | Purpose |
|---|---|
slack_workflow_save | Save a typed workflow profile to ~/.slack-mcp-workflows.json |
slack_workflows | List saved workflow profiles |
slack_catch_me_up | Read a profile's channels since its cadence window and return structured catch-up evidence |
slack_refresh_tokens reads Slack and writes only local credential state.
Typed workflows: Slack in, JSON out
Bind a workflow kind to channels, priority people, retention, and cadence. slack_catch_me_up then reads that scope locally and hands your agent the evidence: which threads went unanswered and for how long, what your priority people said or were pinned on, which conversations actually moved. It does the gathering; your agent writes the summary against the contract below.
There is no server-side model in that path, because there does not need to be one — the client calling this server is already a language model. Hosted adds what needs a server: running the same catch-up on a schedule while your laptop is shut.
npx -y @jtalk22/slack-mcp --apply-template oncall-handoff --channels C012345,C067890
Workflow contracts and shipped templates
| Workflow kind | Contract |
|---|---|
incident_room | {incident_summary, timeline, open_risks, owner_gaps, next_actions} |
exec_brief | {summary, decisions, risks, asks, action_items} |
support_inbox | {open_threads, ack_lag, owner_gaps, escalations, next_actions} |
product_launch_watch | {launch_signals, feedback_themes, blockers, metrics, next_actions} |
custom | {summary, highlights, open_questions, next_actions} |
Six editable templates ship in the package: oncall-handoff, support-triage, exec-monday, sprint-tracker, customer-feedback, and incident-room.
Security and provenance
Every message this server returns becomes text in a model's context, next to your own instructions. Slack is a shared bus: a channel can hold Slack Connect participants from another workspace, guests, and apps relaying content from outside Slack entirely — and the same toolset that reads also writes. That adjacency is the risk worth naming.
- Credential files are owner-only; Keychain-only mode keeps plaintext credentials off disk.
- Configuration fails closed for unknown storage modes and invalid profiles.
- Writes are atomic and shared credential state is process-locked.
- The local web server binds to localhost; workspace write tools carry destructive annotations.
- Every release publishes from CI with npm provenance.
Author labels on every message
Each message carries origin (self, internal, external, bot, unknown) and author_trusted, derived from fields Slack already returns, so it costs no extra API call. bot outranks workspace membership, because an app inside your workspace routinely relays words written outside it. A batch containing outside authors carries an untrusted_content envelope naming the count.
It fails closed: an author this server cannot positively place inside your workspace is reported untrusted. The exception is a conversation Slack reports as not shared with any other workspace — one of those structurally cannot hold an outside author, so a colleague with no team id on their message is called internal rather than unknown. When that lookup fails, the label stays unknown.
SLACK_MCP_PROVENANCE=off|label|strict. label is the default and only adds keys. A per-call provenance argument may tighten the mode and never loosen it, because a caller asking for fewer labels may be repeating something it read.
What the labels cannot do
A label is advice to the model reading it. It is unsigned, it can be stripped by anything downstream, and it raises the cost of an injected instruction without making one impossible.
strict mode additionally holds slack_send_message once the session has read outside-authored text. The hold is released by confirm_untrusted_context, which the caller sets — so it interrupts the send and puts it on the record, but it cannot prove a human approved it.
Two surfaces are still unlabelled, and knowing that is better than assuming otherwise: user display names, real names and titles from the user tools, and channel topics and purposes from slack_list_conversations, are attacker-settable free text that reaches the model without an origin stamp.
Read-only mode, for when a label is not enough
npx -y @jtalk22/slack-mcp --read-only # or SLACK_MCP_READ_ONLY=1
The four write-path tools are withheld from tools/list and refused at dispatch, because a client can call a name it was never offered. The filter is applied after the tool profile resolves, so no profile or custom tool list widens it back. An absent tool needs no trust in the model that would have called it.
The receipt
slack_session_report returns what this process actually did: messages read, how many were outside-authored and by which origin, writes attempted, writes held. Counts only — no message text, no channel name, no user id. A label is a claim about one message; this is the claim about the session, and it is how you check afterwards whether outside text reached the model and whether anything tried to send on the back of it.
Verify the release
npm audit signatures
A clean result means the package you installed was built and signed by this repository's release workflow. Read the code before giving it your Slack session. Full policy: SECURITY.md.
How it works
Five parts sit under the tools: extraction from Chrome, credential storage, reads, writes, and typed workflow output. All of it is plain JavaScript in this repository.
The five parts
1. Extraction from Chrome
--setup turns the Slack identity Chrome already holds into a local MCP server:
- finds the newest
xoxc-token in Chrome's on-disk LevelDB; - snapshots the cookie SQLite database with its WAL sidecars;
- retrieves Chrome Safe Storage from the macOS Keychain;
- runs Chrome-compatible PBKDF2 + AES-128-CBC decryption locally;
- requires no DevTools, clipboard step, browser flag, or live Slack tab;
- names the failed extraction stage—
keychain_timeout,no_slack_cookie_row,cookie_decrypt_failed, and more—instead of returning one opaque error.
2. Credential storage
Slack session credentials rotate. The server handles that with:
auto,keychain-only, andfilestorage backends;- owner-only token files and a Keychain-only path with no plaintext credentials on disk;
- atomic file writes, verified Keychain migration, cross-process locks, and refresh mutexes;
- proactive health checks and automatic macOS refresh;
- last-known-good in-memory credentials when persistence is temporarily unavailable;
- isolated profiles for work and personal Slack;
- fail-closed handling for invalid storage or profile configuration.
3. Reads
Read DMs and channels, search the workspace, export complete histories with threads, inspect unread state, and resolve users. Opt into blocks, attachments, files, reactions, metadata, and bot/app markers when text alone is not the real message.
4. Writes
Send a reply, add or remove a reaction, and mark a conversation read. Every write tool carries MCP's destructive annotation, so compatible clients ask before running it.
5. Typed workflow output
Save workflow profiles for incident rooms, executive briefs, support inboxes, launch watches, and your own. Profiles are local JSON; the hosted tier can deliver them as scheduled briefs.
Credentials
The server checks these in order and uses the first it finds.
| Source | Where it comes from | |
|---|---|---|
| 1 | SLACK_TOKEN + SLACK_COOKIE | your client's environment configuration |
| 2 | Token file | written by --setup, chmod 600 |
| 3 | macOS Keychain | written by --setup |
| 4 | Chrome extraction | macOS only, run on demand |
Session credentials expire, and how long they last varies: one written on 2026-07-04 still worked on 2026-10-07. slack_token_status shows the age of yours. When Slack rejects it (invalid_auth, not_authed, token_expired, token_revoked, account_inactive or HTTP 401), run npx -y @jtalk22/slack-mcp --setup. On macOS, slack_refresh_tokens or --refresh-tokens refreshes without leaving your client, and the optional LaunchAgent in docs/SETUP.md keeps an idle install working.
Enterprise Grid, extraction, and caching
Enterprise Grid. Grid runs aggressive session-anomaly detection. Browser-session automation can trip it, which flags the session and kills it, regardless of which tool drives the traffic. Outbound calls are paced by default to stay under burst thresholds (SLACK_MCP_MIN_REQUEST_INTERVAL_MS, default 350; SLACK_MCP_MAX_CONCURRENCY, default 3). Pacing lowers that risk; it does not remove it. On Grid, use Slack's official MCP server.
Credential extraction. --setup reads the newest xoxc- token from Chrome's on-disk LevelDB, snapshots the cookie SQLite database, retrieves Chrome Safe Storage from the macOS Keychain, and runs PBKDF2 + AES-128-CBC decryption locally. It writes the token file, Keychain entries, and non-secret metadata. It transmits nothing — the server talks to Slack and nowhere else.
This is the same access pattern credential stealers use. Chrome App-Bound Encryption exists to make this class of read harder, and infostealer families (Lumma, Vidar, Meduza) bypass it to lift live sessions. The mechanism here is comparable. What differs is that you run it, on your own machine, against your own session, and nothing leaves the host. The source is plain JavaScript in this repository; audit it before handing it a live session.
User cache. One cache exists: user-name lookups, populated on demand, 500 entries maximum, one-hour TTL. No message content, no channel history, and no persistent copy of the workspace is stored.
Storage modes and multi-workspace profiles
| Mode | Behavior |
|---|---|
auto | Token file plus Keychain backup |
keychain-only | Keychain only; verified writes and no plaintext credential file |
file | Owner-only token file; Keychain is never touched |
The selected backend is remembered in non-secret metadata and used by the server, CLI, and optional refresh job. An unrecognized mode fails at startup instead of silently downgrading storage.
{
"mcpServers": {
"slack-work": {
"command": "npx",
"args": ["-y", "@jtalk22/slack-mcp"],
"env": { "SLACK_MCP_PROFILE": "work" }
},
"slack-personal": {
"command": "npx",
"args": ["-y", "@jtalk22/slack-mcp"],
"env": { "SLACK_MCP_PROFILE": "personal" }
}
}
}
Each profile gets its own token file, Keychain entries, metadata, and lock. Add SLACK_MCP_CHROME_PROFILE when the workspaces live in different Chrome profiles.
Local and hosted
The package runs on your machine, talks only to Slack, and is free under the MIT license. The hosted tier runs on a schedule instead, so the brief arrives while your laptop is closed:
- catch-up on a schedule, in your timezone;
- briefs built from your saved workflow profiles;
- profiles shared across a team;
- delivery to Slack or a signed webhook.
The package works without the hosted tier.
Documentation
Setup · API · Architecture · Compatibility · Deployment modes · Recipes · Troubleshooting · Roadmap
Contributing
PRs are welcome. Read CONTRIBUTING.md and run node --check on touched JavaScript before submitting.
License
MIT — see LICENSE.
Disclaimer
Not affiliated with Slack Technologies, Inc. This server uses browser-session credentials. Review your workspace's acceptable-use policy before running it.
Your Slack. Your agent. One command.
If this removes a Slack tab from your day, star the repository. Stars are how the next admin-blocked developer finds the local path.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
SLACK_TOKENsecretSlack xoxc- token from browser session
SLACK_COOKIEsecretSlack xoxd- cookie from browser session
Categories
Registryactive
Package@jtalk22/slack-mcp
TransportSTDIO, HTTP
AuthRequired
UpdatedMar 12, 2026
