> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Slack

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Summarize everything discussed in `#incidents-prod` over the last 24 hours.
* Find every message in `#engineering` mentioning `broken` from this week and create a Linear ticket for each.
* Send a weekly update to `#leadership` with the deliverables shipped this week.

## Available Tools

#### list_channels

List all channels in the workspace

#### create_channel

Create a new channel

#### get_channel_info

Get information about a channel using Channel ID (not channel name)

#### join_channel

Join a channel

#### leave_channel

Leave a channel

#### archive_channel

Archive a channel

#### unarchive_channel

Unarchive a channel

#### get_channel_members

Get members of a channel

#### invite_to_channel

Invite users to a channel

#### kick_from_channel

Remove a user from a channel

#### set_channel_topic

Set the topic for a channel

#### set_channel_purpose

Set the purpose for a channel

#### rename_channel

Rename a channel

#### get_file_info

Get information about a file

#### list_files

List files in the workspace

#### delete_file

Delete a file

#### share_file

Share a file to channels

#### get_file_content

Get the content of a text file

#### make_file_public

Make a file publicly accessible

#### revoke_file_public_url

Revoke public access to a file

#### post_message

Send a message to a Slack channel using Channel ID (not channel name)

#### update_message

Update an existing message in Slack

#### delete_message

Delete a message from Slack

#### get_message_permalink

Get a permanent link to a message

#### get_conversation_history

Get message history from a channel using Channel ID with enhanced timestamp filtering.

#### schedule_message

Schedule a message to be sent later

#### delete_scheduled_message

Delete a scheduled message

#### add_reaction

Add an emoji reaction to a message

#### remove_reaction

Remove an emoji reaction from a message

#### get_conversation_replies

Get all replies in a Slack thread.

#### list_unread_direct_messages

Get all unread direct messages and group DMs with their message content. When presenting results to users, always display username/display_name instead of user_id for better readability.

#### list_unread_channel_messages

Get all unread messages from channels with their message content.

#### list_scheduled_messages

List scheduled messages that haven't been sent yet

#### 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. When presenting results to users, always display username/display_name instead of user_id for better readability.

#### list_pinned_messages

List all pinned messages and items in a channel

#### pin_message

Pin a message to a channel

#### unpin_message

Remove a pinned message from a channel

#### search_messages

Search Slack messages using Slack's exact search syntax with enhanced timestamp filtering.

#### search_files

Search for files across Slack using keywords with enhanced timestamp handling and automatic pagination.

#### get_user_info

Get complete user information including workspace role, permissions, and profile

#### list_users

List all users in the workspace

#### lookup_user_by_email

Look up a user by their email address

#### get_user_presence

Get a user's presence status

#### set_user_presence

Set your own presence status (auto or away)

#### set_user_profile

Set profile information for a user

#### get_users_conversations

Get conversations a user is a member of

#### set_user_status

Set status text and emoji for a user. Only sends emoji parameter when provided (not null/empty).

#### clear_user_status

Clear the status for a user

#### post_message_by_name

Send a message to a person or channel by name instead of ID. Resolves display name, real name, username, or channel name to the correct ID and sends t…