Slack
Comprehensive Slack connector for managing messages, channels, users, and file operations.
📝 Note: This connector gives agents access to Slack data. To chat with your agents inside Slack, see Slack integration.
What you can ask
- Summarize everything discussed in
#incidents-prodover the last 24 hours. - Find every message in
#engineeringmentioningbrokenfrom this week and create a Linear ticket for each. - Send a weekly update to
#leadershipwith the deliverables shipped this week.
Set up
Slack needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Slack. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Slack app dashboard.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Slack login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (40)
Grant the scopes for the tools you plan to allow.
bookmarks:readbookmarks:writecanvases:writechannels:historychannels:readchannels:writechannels:write.inviteschannels:write.topicchat:writednd:writefiles:readfiles:writegroups:historygroups:readgroups:writeim:historyim:readim:writempim:historympim:readmpim:writepins:readpins:writereactions:readreactions:writesearch:readsearch:read.filessearch:read.imsearch:read.mpimsearch:read.privatesearch:read.publicsearch:read.usersteam:readusergroups:readusergroups:writeusers.profile:readusers.profile:writeusers:readusers:read.emailusers:write
Tools
Slack offers 79 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (32)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_channel_info | Get information about a channel using Channel ID (not channel name) |
get_channel_members | Get members of a channel |
get_conversation_history | Get message history from a channel by Channel ID. |
get_conversation_replies | Get all replies in a Slack thread. |
get_current_user | Resolve the authenticated user ('me'/'myself') to their Slack user ID and profile. |
get_file_content | Get the content of a file. |
get_file_info | Get a file's metadata: name, type, size, owner and share locations. |
get_message_permalink | Get a permanent link to a message |
get_reactions | Read the emoji reactions on a message: which emoji, how many people used each, and the user IDs who did. |
get_team_info | Get the authenticated user's Slack workspace: its ID, name, slug and email domain. |
get_unread_messages_from_channel | Get all unread messages from a specific channel. |
get_unread_messages_from_user | Get all unread direct messages from a specific user. |
get_user_info | Get complete user information including workspace role, permissions, and profile |
get_user_presence | Check whether a user is active or away. |
get_user_profile | Get a user's full Slack profile including title, phone, timezone, status and any workspace custom fields. |
get_users_conversations | Get conversations a user is a member of. |
list_bookmarks | List the bookmarks pinned to a channel's header. |
list_channels | List channels in the workspace (public and private; direct messages are excluded by default). |
list_files | List files in the workspace, most recent first by default. sort (created|timestamp) and sort_dir (asc|desc) order the returned page only - files.list has no server-side sort, so ordering is not consistent across pages. |
list_pinned_messages | List all pinned messages and items in a channel |
list_scheduled_messages | List scheduled messages that haven't been sent yet |
list_unread_channel_messages | Get all unread messages from channels with their message content. |
list_unread_direct_messages | Get all unread direct messages and group DMs with their message content. |
list_usergroup_users | List the member user IDs of one user group. |
list_usergroups | List the workspace's user groups (mentionable @handles, also called subteams). |
list_users | List users in the workspace. |
lookup_user_by_email | Resolve an email address to a Slack user, returning their ID and profile. |
read_file_text | Read a Slack file as text; prefer over get_file_content to READ a PDF, DOCX, XLSX or text file. file_id: list_files or search_files. |
search_context | Search Slack semantically, built for agents. |
search_files | Search for files across Slack using keywords with enhanced timestamp handling and automatic pagination. |
search_messages | Search Slack messages using Slack's exact search syntax. |
validate_credential | Validate Slack credentials. |
Write (17)
Create or send data.
| Tool | What it does |
|---|---|
add_bookmark | Pin a link to a channel's header as a bookmark. |
add_reaction | Add an emoji reaction to a message |
create_canvas | Create a new standalone Slack canvas with optional title and markdown content. |
create_channel | Create a new channel |
create_channel_canvas | Create a canvas linked to a Slack channel. |
create_usergroup | Create a user group (a mentionable @handle). |
invite_to_channel | Invite one or more users to a channel by ID. |
invite_usergroup_to_channel | Invite every current member of a user group to a channel. |
join_channel | Join a channel |
open_dm | Open a direct message conversation with one user, or a group DM with several, and return the conversation ID to pass to post_message. |
pin_message | Pin a message to a channel |
post_ephemeral_message | Post a message only one user can see in a channel, leaving no trace for anyone else. |
post_message | Send a message to a Slack channel using Channel ID (not channel name). |
post_message_by_name | Send a message to a person or channel by name instead of ID. |
schedule_message | Schedule a message to be sent later |
share_file | Share an existing file into one or more channels by posting its permalink, which Slack unfurls into a file attachment. |
upload_file | Upload a file or image to Slack. |
Delete or overwrite (30)
Remove or replace existing data.
| Tool | What it does |
|---|---|
archive_channel | Archive a channel, making it read-only for everyone. |
clear_user_status | Clear the status for a user |
close_conversation | Close a direct message or group direct message, removing it from your own sidebar. |
delete_canvas | Permanently delete a Slack canvas by ID. |
delete_file | Permanently delete a file and remove it from every conversation it was shared in. |
delete_message | Delete a message from Slack |
delete_scheduled_message | Delete a scheduled message |
disable_usergroup | Disable a user group so it can no longer be mentioned. |
edit_bookmark | Change an existing channel bookmark's title, link or emoji. |
edit_canvas | Write to or edit an existing Slack canvas by applying one or more change operations. |
enable_usergroup | Re-enable a disabled user group so it can be mentioned again. |
kick_from_channel | Remove a user from a channel |
leave_channel | Leave a public or private channel you are a member of. |
make_file_public | Create a public share URL for a file, readable without a Slack account. |
mark_channel_read | Mark a channel as read up to a given message, clearing its unread badge for the authenticated user. |
remove_bookmark | Remove a bookmark from a channel's header. |
remove_reaction | Remove an emoji reaction from a message |
rename_channel | Rename a channel |
revoke_file_public_url | Revoke a file's public share URL, so it is again readable only inside Slack. |
set_channel_purpose | Set the purpose for a channel |
set_channel_topic | Set the topic for a channel |
set_dnd_duration | Turn on Do Not Disturb for your own account for a number of minutes from now. |
set_user_presence | Set your own presence status (auto or away) |
set_user_profile | Set profile information for a user |
set_user_status | Set your status text and emoji. status_text is required: pass an empty string to clear it. |
set_usergroup_users | Replace a user group's entire membership with the given user IDs. |
unarchive_channel | Restore a previously archived channel to active use. |
unpin_message | Remove a pinned message from a channel |
update_message | Update an existing message in Slack. |
update_usergroup | Update a user group's name, handle, description, or default channels. |