Slack

Learn how to use Slack with Composio

Overview

SLUG: SLACK

Description

Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
user_scopes
stringDefaults to calls:read,calls:write,channels:history,channels:read,channels:write,chat:write,dnd:read,dnd:write,emoji:read,files:read,files:write,groups:history,groups:read,groups:write,im:history,im:read,im:write,links:read,links:write,mpim:history,mpim:read,mpim:write,pins:read,pins:write,reactions:read,reactions:write,reminders:read,reminders:write,remote_files:read,remote_files:share,search:read,stars:read,stars:write,team:read,usergroups:read,usergroups:write,users.profile:read,users.profile:write,users:read,users:read.email,users:write
bearer_token
string
verification_token
string
verification_token
string
token
stringRequired

Connecting to Slack

Create an auth config

Use the dashboard to create an auth config for the Slack toolkit. This allows you to connect multiple Slack accounts to Composio for agents to use.

1

Select App

Navigate to Slack.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Slack Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4slack_auth_config_id = "ac_YOUR_SLACK_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Slack: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, slack_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Using Bearer Token

1from composio import Composio
2
3# Auth config ID created above
4slack_auth_config_id = "ac_YOUR_SLACK_CONFIG_ID"
5
6# UUID from database/application
7user_id = "0000-0000-0000"
8
9composio = Composio()
10
11
12def authenticate_toolkit(user_id: str, auth_config_id: str):
13 # Replace this with a method to retrieve the Bearer Token from the user.
14 bearer_token = input("[!] Enter bearer token")
15 connection_request = composio.connected_accounts.initiate(
16 user_id=user_id,
17 auth_config_id=auth_config_id,
18 config={"auth_scheme": "BEARER_TOKEN", "val": bearer_token}
19 )
20 print(f"Successfully connected Slack for user {user_id}")
21 print(f"Connection status: {connection_request.status}")
22
23 return connection_request.id
24
25
26connection_id = authenticate_toolkit(user_id, slack_auth_config_id)
27
28# You can verify the connection using:
29connected_account = composio.connected_accounts.get(connection_id)
30print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Slack toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["SLACK"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add reaction to message

Description

Adds a specified emoji reaction to an existing message in a slack channel, identified by its timestamp; does not remove or retrieve reactions.

Action Parameters

channel
stringRequired
name
stringRequired
timestamp
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a reminder

Description

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').

Action Parameters

text
stringRequired
time
stringRequired
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch conversation history

Description

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.

Action Parameters

channel
stringRequired
cursor
string
inclusive
boolean
latest
string
limit
integer
oldest
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find channels

Description

Find channels in a slack workspace by any criteria - name, topic, purpose, or description.

Action Parameters

exact_match
boolean
exclude_archived
booleanDefaults to True
limit
integerDefaults to 50
member_only
boolean
search_query
stringRequired
types
stringDefaults to public_channel,private_channel

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find users

Description

Find users in a slack workspace by any criteria - email, name, display name, or other text. includes optimized email lookup for exact email matches.

Action Parameters

exact_match
boolean
include_bots
boolean
include_deleted
boolean
include_restricted
booleanDefaults to True
limit
integerDefaults to 50
search_query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List channels

Description

Lists conversations available to the user with various filters and search options.

Action Parameters

channel_name
string
cursor
string
exclude_archived
boolean
limit
integerDefaults to 1
types
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all users

Description

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.

Action Parameters

cursor
string
include_locale
boolean
limit
integerDefaults to 1

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove reaction from item

Description

Removes an emoji reaction from a message, file, or file comment in slack.

Action Parameters

channel
string
file
string
file_comment
string
name
stringRequired
timestamp
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Schedule message

Description

Schedules a message to a slack channel, dm, or private group for a future time (`post at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
string
link_names
boolean
markdown_text
string
parse
string
post_at
string
reply_broadcast
boolean
text
string
thread_ts
string
unfurl_links
boolean
unfurl_media
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search messages

Description

Searches messages in a slack workspace using a query with optional modifiers (e.g., `in:`, `from:`, `has:`, `before:`) across accessible channels, dms, and private groups.

Action Parameters

count
integerDefaults to 1
highlight
boolean
page
integer
query
stringRequired
sort
string
sort_dir
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send message

Description

Posts a message to a slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
stringRequired
icon_emoji
string
icon_url
string
link_names
boolean
markdown_text
string
mrkdwn
boolean
parse
string
reply_broadcast
boolean
text
string
thread_ts
string
unfurl_links
boolean
unfurl_media
boolean
username
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a Slack message

Description

Updates a slack message, identified by `channel` id and `ts` timestamp, by modifying its `text`, `attachments`, or `blocks`; provide at least one content field, noting `attachments`/`blocks` are replaced if included (`[]` clears them).

Action Parameters

as_user
string
attachments
string
blocks
string
channel
stringRequired
link_names
string
markdown_text
string
parse
string
text
string
ts
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set snooze duration

Description

Deprecated: turns on do not disturb mode for the current user, or changes its duration. use `set dnd duration` instead.

Action Parameters

num_minutes
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add an emoji alias

Description

Adds an alias for an existing custom emoji in a slack enterprise grid organization.

Action Parameters

alias_for
stringRequired
name
stringRequired
token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add a custom emoji to a Slack team

Description

Deprecated: adds a custom emoji to a slack workspace given a unique name and an image url. use `add emoji` instead.

Action Parameters

name
stringRequired
token
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add a remote file

Description

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.

Action Parameters

external_id
string
external_url
string
filetype
string
indexable_file_contents
string
preview_image
string
title
string
token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add a star to an item

Description

Stars a channel, file, file comment, or a specific message in slack.

Action Parameters

channel
string
file
string
file_comment
string
timestamp
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add call participants

Description

Registers new participants added to a slack call.

Action Parameters

id
stringRequired
users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add emoji

Description

Adds a custom emoji to a slack workspace given a unique name and an image url; subject to workspace emoji limits.

Action Parameters

name
stringRequired
token
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive a public or private channel

Description

Archives a slack public or private channel, making it read-only; the primary 'general' channel cannot be archived.

Action Parameters

channel_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Archive a Slack conversation

Description

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.

Action Parameters

channel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Post message to channel

Description

Deprecated: posts a message to a slack channel, direct message, or private channel. use `send message` instead.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
stringRequired
icon_emoji
string
icon_url
string
link_names
boolean
markdown_text
string
mrkdwn
boolean
parse
string
reply_broadcast
boolean
text
string
thread_ts
string
unfurl_links
boolean
unfurl_media
boolean
username
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Close conversation channel

Description

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.

Action Parameters

channel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a Slack user group

Description

Creates a new user group (often referred to as a subteam) in a slack workspace.

Action Parameters

channels
string
description
string
handle
string
include_count
boolean
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create channel

Description

Initiates a public or private channel-based conversation

Action Parameters

is_private
boolean
name
stringRequired
team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a channel-based conversation

Description

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).

Action Parameters

description
string
is_private
booleanRequired
name
stringRequired
org_wide
boolean
team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Customize URL unfurl

Description

Customizes url previews (unfurling) in a specific slack message using a url-encoded json in `unfurls` to define custom content or remove existing previews.

Action Parameters

channel
stringRequired
ts
stringRequired
unfurls
string
user_auth_message
string
user_auth_required
boolean
user_auth_url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Customize URL unfurling in messages

Description

Deprecated: customizes url previews (unfurling) in a specific slack message. use `customize url unfurl` instead.

Action Parameters

channel
stringRequired
ts
stringRequired
unfurls
string
user_auth_message
string
user_auth_required
boolean
user_auth_url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a message from a chat

Description

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.

Action Parameters

as_user
boolean
channel
string
ts
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete file comment

Description

Deletes a specific comment from a file in slack; this action is irreversible.

Action Parameters

file
string
id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a file by ID

Description

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.

Action Parameters

file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a public or private channel

Description

Permanently and irreversibly deletes a specified public or private channel, including all its messages and files, within a slack enterprise grid organization.

Action Parameters

channel_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete scheduled chat message

Description

Deletes a pending, unsent scheduled message from the specified slack channel, identified by its `scheduled message id`.

Action Parameters

as_user
boolean
channel
stringRequired
scheduled_message_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a Slack reminder

Description

Deletes an existing slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.

Action Parameters

reminder
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete user profile photo

Description

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.

Action Parameters

token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Disable a Slack user group

Description

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.

Action Parameters

include_count
boolean
usergroup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Enable a user group

Description

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.

Action Parameters

include_count
boolean
usergroup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Share file public url

Description

Enables public sharing for an existing slack file by generating a publicly accessible url; this action does not create new files.

Action Parameters

file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: End a call

Description

Ends an ongoing slack call, identified by its id (obtained from `calls.add`), optionally specifying the call's duration.

Action Parameters

duration
integer
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: End snooze

Description

Ends the current user's snooze mode immediately.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: End DND session

Description

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.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: End snooze mode immediately

Description

Deprecated: ends the current user's snooze mode immediately. use `end snooze` instead.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch bot user information

Description

Fetches information for a specified, existing slack bot user; will not work for regular user accounts or other integration types.

Action Parameters

bot
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch team information

Description

Deprecated: fetches comprehensive metadata about the current slack team. use `fetch team info` instead.

Action Parameters

team
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Do Not Disturb status for users

Description

Deprecated: retrieves a user's current do not disturb status. use `get team dnd status` instead.

Action Parameters

users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch item reactions

Description

Fetches reactions for a slack message, file, or file comment, requiring one of: channel and timestamp; file id; or file comment id.

Action Parameters

channel
string
file
string
file_comment
string
full
boolean
timestamp
string

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Retrieve conversation replies

Description

Retrieves replies to a specific parent message in a slack conversation, using the channel id and the parent message's timestamp (`ts`).

Action Parameters

channel
string
cursor
string
inclusive
boolean
latest
string
limit
integer
oldest
string
ts
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch team info

Description

Fetches comprehensive metadata about the current slack team, or a specified team if the provided id is accessible.

Action Parameters

team
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Fetch workspace settings information

Description

Retrieves detailed settings for a specific slack workspace, primarily for administrators in an enterprise grid organization to view or audit workspace configurations.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup users by email

Description

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.

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get channel conversation preferences

Description

Retrieves conversation preferences (e.g., who can post, who can thread) for a specified channel, primarily for use within slack enterprise grid environments.

Action Parameters

channel_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get reminder information

Description

Retrieves detailed information for an existing slack reminder specified by its id; this is a read-only operation.

Action Parameters

reminder
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get remote file

Description

Retrieve information about a remote file added to slack.

Action Parameters

external_id
string
file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get team DND status

Description

Retrieves a user's current do not disturb status.

Action Parameters

users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve user presence

Description

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.

Action Parameters

user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create conversation

Description

Deprecated: initiates a public or private channel-based conversation. use `create channel` instead.

Action Parameters

is_private
boolean
name
stringRequired
team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite users to a Slack channel

Description

Invites users to an existing slack channel using their valid slack user ids.

Action Parameters

channel
string
users
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite users to channel

Description

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.

Action Parameters

channel_id
stringRequired
user_ids
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite user to workspace

Description

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.

Action Parameters

channel_ids
stringRequired
custom_message
string
email
stringRequired
guest_expiration_ts
string
is_restricted
boolean
is_ultra_restricted
boolean
real_name
string
resend
boolean
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite user to workspace and channels

Description

Deprecated: invites a user to a slack workspace and specified channels by email. use `invite user to workspace` instead.

Action Parameters

channel_ids
stringRequired
custom_message
string
email
stringRequired
guest_expiration_ts
string
is_restricted
boolean
is_ultra_restricted
boolean
real_name
string
resend
boolean
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Join conversation by channel id

Description

Joins an existing slack conversation (public channel, private channel, or multi-person direct message) by its id, if the authenticated user has permission.

Action Parameters

channel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Leave conversation channel

Description

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.

Action Parameters

channel
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List pinned items in a channel

Description

Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel.

Action Parameters

channel
stringRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: List starred items

Description

Deprecated: lists items starred by a user. use `list starred items` instead.

Action Parameters

count
integer
cursor
string
limit
integer
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List accessible conversations for a user

Description

Deprecated: retrieves conversations accessible to a specified user. use `list conversations` instead.

Action Parameters

cursor
string
exclude_archived
boolean
limit
integer
types
string
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List conversations

Description

Deprecated: lists conversations available to the user with various filters and search options. use `list channels` instead.

Action Parameters

channel_name
string
cursor
string
exclude_archived
boolean
limit
integerDefaults to 1
types
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all Slack team users with pagination

Description

Deprecated: retrieves a paginated list of all users in a slack workspace. use `list all users` instead.

Action Parameters

cursor
string
include_locale
boolean
limit
integerDefaults to 1

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all users in a user group

Description

Retrieves a list of all user ids within a specified slack user group, with an option to include users from disabled groups.

Action Parameters

include_disabled
boolean
usergroup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List conversations

Description

Retrieves conversations accessible to a specified user (or the authenticated user if no user id is provided), respecting shared membership for non-public channels.

Action Parameters

cursor
string
exclude_archived
boolean
limit
integer
types
string
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Slack files

Description

Lists files and their metadata within a slack workspace, filterable by user, channel, timestamp, or type; this action returns metadata only, not file content.

Action Parameters

channel
string
count
string
page
string
show_files_hidden_by_limit
boolean
ts_from
integer
ts_to
integer
types
string
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List reminders

Description

Lists all reminders with their details for the authenticated slack user; returns an empty list if no reminders exist.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List remote files

Description

Retrieve information about a team's remote files.

Action Parameters

channel
string
cursor
string
limit
integer
ts_from
number
ts_to
number

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List scheduled messages

Description

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.

Action Parameters

channel
string
cursor
string
latest
string
limit
integer
oldest
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List scheduled messages in a channel

Description

Deprecated: retrieves a list of pending (not yet delivered) messages scheduled in a specific slack channel. use `list scheduled messages` instead.

Action Parameters

channel
string
cursor
string
latest
string
limit
integer
oldest
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List team remote files

Description

Deprecated: retrieve information about a team's remote files. use `list remote files` instead.

Action Parameters

channel
string
cursor
string
limit
integer
ts_from
number
ts_to
number

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List starred items

Description

Lists items starred by a user.

Action Parameters

count
integer
cursor
string
limit
integer
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List team custom emojis

Description

Retrieves all custom emojis for the slack workspace (image urls or aliases), not standard unicode emojis; does not include usage statistics or creation dates.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List user groups

Description

Lists user groups in a slack workspace, including user-created and default groups; results for large workspaces may be paginated.

Action Parameters

include_count
boolean
include_disabled
boolean
include_users
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List user reactions

Description

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.

Action Parameters

count
integer
cursor
string
full
boolean
limit
integer
page
integer
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List user reminders with details

Description

Deprecated: lists all reminders with their details for the authenticated slack user. use `list reminders` instead.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List admin users

Description

Retrieves a paginated list of admin users for a specified slack workspace.

Action Parameters

cursor
string
limit
integer
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set user presence

Description

Manually sets a user's slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or slack's auto-away (e.g., after 10 mins of inactivity).

Action Parameters

presence
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Mark reminder as complete

Description

Marks a specific slack reminder as complete using its `reminder` id; **deprecated**: this slack api endpoint ('reminders.complete') was deprecated in march 2023 and is not recommended for new applications.

Action Parameters

reminder
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Open DM

Description

Opens or resumes a slack direct message (dm) or multi-person direct message (mpim) by providing either user ids or an existing channel id.

Action Parameters

channel
string
return_im
boolean
users
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Open or resume direct or multi-person messages

Description

Deprecated: opens or resumes a slack direct message (dm) or multi-person direct message (mpim). use `open dm` instead.

Action Parameters

channel
string
return_im
boolean
users
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Pin an item to a channel

Description

Pins a message to a specified slack channel; the message must not already be pinned.

Action Parameters

channel
stringRequired
timestamp
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Register a new call with participants

Description

Deprecated: registers a new call in slack using `calls.add` for third-party call integration. use `start call` instead.

Action Parameters

created_by
string
date_start
integer
desktop_app_join_url
string
external_display_id
string
external_unique_id
stringRequired
join_url
stringRequired
title
string
users
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Register new call participants

Description

Deprecated: registers new participants added to a slack call. use `add call participants` instead.

Action Parameters

id
stringRequired
users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove participants from call

Description

Deprecated: registers participants removed from a slack call. use `remove call participants` instead.

Action Parameters

id
stringRequired
users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove remote file

Description

Removes the slack reference to an external file (which must have been previously added via the remote files api), specified by either its `external id` or `file` id (one of which is required), without deleting the actual external file.

Action Parameters

external_id
string
file
string
token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove a star from an item

Description

Removes a star from a previously starred slack item (message, file, file comment, channel, group, or dm), requiring identification via `file`, `file comment`, `channel` (for channel/group/dm), or both `channel` and `timestamp` (for a message).

Action Parameters

channel
string
file
string
file_comment
string
timestamp
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove user from conversation

Description

Removes a specified user from a slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action.

Action Parameters

channel
string
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove call participants

Description

Registers participants removed from a slack call.

Action Parameters

id
stringRequired
users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Rename an emoji

Description

Renames an existing custom emoji in a slack workspace, updating all its instances.

Action Parameters

name
stringRequired
new_name
stringRequired
token
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Rename a conversation

Description

Renames a slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name.

Action Parameters

channel
string
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Rename a Slack channel

Description

Renames a public or private slack channel; for enterprise grid workspaces, the user must be a workspace admin or channel manager.

Action Parameters

channel_id
stringRequired
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve a user’s identity details

Description

Retrieves the authenticated user's and their team's identity, with details varying based on oauth scopes (e.g., `identity.basic`, `identity.email`, `identity.avatar`).

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Retrieve call information

Description

Retrieves a point-in-time snapshot of a specific slack call's information.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve conversation information

Description

Retrieves metadata for a slack conversation by id (e.g., name, purpose, creation date, with options for member count/locale), excluding message content; requires a valid channel id.

Action Parameters

channel
string
include_locale
boolean
include_num_members
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get conversation members

Description

Retrieves a paginated list of active member ids for a specified slack public channel, private channel, direct message (dm), or multi-person direct message (mpim).

Action Parameters

channel
string
cursor
string
limit
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve user DND status

Description

Retrieves a slack user's current do not disturb (dnd) status to determine their availability before interaction; any specified user id must be a valid slack user id.

Action Parameters

user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve detailed file information

Description

Retrieves detailed metadata and paginated comments for a specific slack file id; does not download file content.

Action Parameters

count
string
cursor
string
file
string
limit
integer
page
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve detailed user information

Description

Retrieves comprehensive information for a valid slack user id, excluding message history and channel memberships.

Action Parameters

include_locale
boolean
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve remote file info

Description

Deprecated: retrieve information about a remote file added to slack. use `get remote file` instead.

Action Parameters

external_id
string
file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve team profile details

Description

Retrieves all profile field definitions for a slack team, optionally filtered by visibility, to understand the team's profile structure.

Action Parameters

visibility
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve user profile information

Description

Retrieves profile information for a specified slack user (defaults to the authenticated user if `user` id is omitted); a provided `user` id must be valid.

Action Parameters

include_labels
boolean
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unarchive conversation

Description

Deprecated: reverses conversation archival. use `unarchive channel` instead.

Action Parameters

channel
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Revoke a file’s public url

Description

Revokes a slack file's public url, making it private; this is a no-op if not already public and is irreversible.

Action Parameters

file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Schedule message in chat

Description

Deprecated: schedules a message to a slack channel, dm, or private group for a future time. use `schedule message` instead.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
string
link_names
boolean
markdown_text
string
parse
string
post_at
string
reply_broadcast
boolean
text
string
thread_ts
string
unfurl_links
boolean
unfurl_media
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search Messages

Description

Deprecated: searches messages in a slack workspace using a query with optional modifiers. use `search messages` instead.

Action Parameters

count
integerDefaults to 1
highlight
boolean
page
integer
query
stringRequired
sort
string
sort_dir
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send a message to a Slack channel

Description

Deprecated: posts a message to a slack channel, direct message, or private group. use `send message` instead.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
stringRequired
icon_emoji
string
icon_url
string
link_names
boolean
markdown_text
string
mrkdwn
boolean
parse
string
reply_broadcast
boolean
text
string
thread_ts
string
unfurl_links
boolean
unfurl_media
boolean
username
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send an ephemeral message

Description

Deprecated: sends an ephemeral message to a user in a channel. use `send ephemeral message` instead.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
stringRequired
icon_emoji
string
icon_url
string
link_names
boolean
parse
string
text
string
thread_ts
string
user
stringRequired
username
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send ephemeral message

Description

Sends an ephemeral message to a user in a channel.

Action Parameters

as_user
boolean
attachments
string
blocks
string
channel
stringRequired
icon_emoji
string
icon_url
string
link_names
boolean
parse
string
text
string
thread_ts
string
user
stringRequired
username
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set a conversation’s purpose

Description

Sets the purpose (a short description of its topic/goal, displayed in the header) for a slack conversation; the calling user must be a member.

Action Parameters

channel
string
purpose
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set DND duration

Description

Turns on do not disturb mode for the current user, or changes its duration.

Action Parameters

num_minutes
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set profile photo

Description

This method allows the user to set their profile image.

Action Parameters

crop_w
integer
crop_x
integer
crop_y
integer
image
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set conversation read cursor

Description

Marks a message, specified by its timestamp (`ts`), as the most recently read for the authenticated user in the given `channel`, provided the user is a member of the channel and the message exists within it.

Action Parameters

channel
string
ts
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set Slack user profile information

Description

Updates a slack user's profile, setting either individual fields or multiple fields via a json object.

Action Parameters

name
string
profile
string
user
string
value
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set conversation topic

Description

Sets or updates the topic for a specified slack conversation.

Action Parameters

channel
string
topic
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set the user’s profile image

Description

Deprecated: this method allows the user to set their profile image. use `set profile photo` instead.

Action Parameters

crop_w
integer
crop_x
integer
crop_y
integer
image
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Share a me message in a channel

Description

Sends a 'me message' (e.g., '/me is typing') to a slack channel, where it's displayed as a third-person user action; messages are plain text and the channel must exist and be accessible.

Action Parameters

channel
string
text
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Share a remote file in channels

Description

Shares a remote file, which must already be registered with slack, into specified slack channels or direct message conversations.

Action Parameters

channels
string
external_id
string
file
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Start call

Description

Registers a new call in slack using `calls.add` for third-party call integration; `created by` is required if not using a user-specific token.

Action Parameters

created_by
string
date_start
integer
desktop_app_join_url
string
external_display_id
string
external_unique_id
stringRequired
join_url
stringRequired
title
string
users
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Start real time messaging session

Description

Initiates a slack rtm session providing a single-use websocket url (valid 30s) for event streaming; does not set initial presence status.

Action Parameters

batch_presence_aware
boolean
presence_sub
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unarchive a public or private channel

Description

Unarchives a specified public or private slack channel that is currently archived, using its channel id.

Action Parameters

channel_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unarchive channel

Description

Reverses conversation archival.

Action Parameters

channel
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Unpin message from channel

Description

Unpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive.

Action Parameters

channel
stringRequired
timestamp
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update an existing remote file

Description

Updates metadata or content details for an existing remote file in slack; this action cannot upload new files or change the fundamental file type.

Action Parameters

external_id
string
external_url
string
file
string
filetype
string
indexable_file_contents
string
preview_image
string
title
string
token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Slack user group

Description

Updates an existing slack user group, which must be specified by an existing `usergroup` id, with new optional details such as its name, description, handle, or default channels.

Action Parameters

channels
string
description
string
handle
string
include_count
boolean
name
string
usergroup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update call information

Description

Updates the title, join url, or desktop app join url for an existing slack call identified by its id.

Action Parameters

desktop_app_join_url
string
id
stringRequired
join_url
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update user group members

Description

Replaces all members of an existing slack user group with a new list of valid user ids.

Action Parameters

include_count
boolean
usergroup
stringRequired
users
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Upload or create a file in Slack

Description

Uploads a file to slack, requiring either `content` (for text) or `file` (for binary data), optionally sharing it in specified `channels` or as a reply via `thread ts`.

Action Parameters

channels
string
content
string
file
string
filename
string
filetype
string
initial_comment
string
thread_ts
integer
title
string
token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired