Slack

Slack MCP Server for Cloudflare Workers

Available Tools

68 tools available in the Slack MCP server. Each tool can be called by AI assistants to perform specific actions.

slack_set_dnd_snooze

Turn on Do Not Disturb for a specified duration.

Args:

num_minutes: Number of minutes to snooze

Temporarily silences notifications.

{
  "type": "object",
  "required": [
    "num_minutes"
  ],
  "properties": {
    "num_minutes": {
      "type": "integer",
      "minimum": 1,
      "description": "Minutes to snooze"
    }
  }
}

slack_end_dnd_snooze

Turn off Do Not Disturb snooze early.

Ends snooze immediately and returns to normal notification status.

{
  "type": "object",
  "properties": {}
}

slack_end_dnd

End Do Not Disturb mode completely.

Ends all DND settings and returns to normal status.

{
  "type": "object",
  "properties": {}
}

slack_list_emoji

List all custom emoji in the workspace.

Args:

format: Response format

Returns: Map of custom emoji names to their URLs/aliases.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_add_pin

Pin a message to a channel.

Args:

channel: Channel ID containing the message
timestamp: Timestamp of the message to pin

Pinned messages appear in the channel's pinned items.

{
  "type": "object",
  "required": [
    "channel",
    "timestamp"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp to pin"
    }
  }
}

slack_add_bookmark

Add a bookmark to a channel.

Args:

channel_id: Channel ID to add bookmark to
title: Bookmark title
type: 'link' or 'folder'
link: URL for link bookmarks
emoji: Optional emoji for the bookmark

Bookmarks appear at the top of the channel.

{
  "type": "object",
  "required": [
    "channel_id",
    "title"
  ],
  "properties": {
    "link": {
      "type": "string",
      "description": "URL for link bookmarks"
    },
    "type": {
      "enum": [
        "link",
        "folder"
      ],
      "type": "string",
      "default": "link"
    },
    "emoji": {
      "type": "string",
      "description": "Emoji for the bookmark"
    },
    "title": {
      "type": "string",
      "description": "Bookmark title"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_edit_bookmark

Edit an existing bookmark.

Args:

channel_id: Channel ID containing the bookmark
bookmark_id: Bookmark ID to edit
title: New title (optional)
link: New URL (optional)
emoji: New emoji (optional)

{
  "type": "object",
  "required": [
    "channel_id",
    "bookmark_id"
  ],
  "properties": {
    "link": {
      "type": "string",
      "description": "New URL"
    },
    "emoji": {
      "type": "string",
      "description": "New emoji"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    },
    "bookmark_id": {
      "type": "string",
      "description": "Bookmark ID"
    }
  }
}

slack_remove_bookmark

Remove a bookmark from a channel.

Args:

channel_id: Channel ID
bookmark_id: Bookmark ID to remove

{
  "type": "object",
  "required": [
    "channel_id",
    "bookmark_id"
  ],
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    },
    "bookmark_id": {
      "type": "string",
      "description": "Bookmark ID"
    }
  }
}

slack_list_bookmarks

List all bookmarks in a channel.

Args:

channel_id: Channel ID
format: Response format

Returns: List of bookmarks in the channel.

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_list_conversations

List Slack channels and conversations with pagination.

Returns public channels, private channels, DMs, and group DMs based on the types parameter.

Args:

types: Comma-separated list of conversation types (public_channel, private_channel, mpim, im)
exclude_archived: Whether to exclude archived channels (default: true)
limit: Number of channels to return (1-100, default: 100)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Number to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "exclude_archived": {
      "type": "boolean",
      "default": true,
      "description": "Exclude archived channels"
    }
  }
}

slack_get_conversation_info

Get detailed information about a specific Slack channel or conversation.

Args:

channel_id: The channel ID (e.g., C1234567890)
format: Response format ('json' or 'markdown')

Returns: Channel name, topic, purpose, member count, and metadata.

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_remove_pin

Unpin a message from a channel.

Args:

channel: Channel ID
timestamp: Timestamp of the pinned message

{
  "type": "object",
  "required": [
    "channel",
    "timestamp"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp to unpin"
    }
  }
}

slack_list_pins

List all pinned items in a channel.

Args:

channel: Channel ID
format: Response format

Returns: List of pinned messages and files.

{
  "type": "object",
  "required": [
    "channel"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_get_conversation_history

Fetch message history from a Slack channel or conversation.

Args:

channel_id: The channel ID
limit: Number of messages to return (1-100, default: 100)
cursor: Pagination cursor
oldest: Only messages after this Unix timestamp
latest: Only messages before this Unix timestamp
format: Response format

Returns: Array of messages with user, text, timestamp, reactions, and thread info.

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "latest": {
      "type": "string",
      "description": "Only messages before this Unix timestamp"
    },
    "oldest": {
      "type": "string",
      "description": "Only messages after this Unix timestamp"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_get_thread_replies

Fetch replies in a message thread.

Args:

channel_id: The channel ID containing the thread
thread_ts: Timestamp of the parent message
limit: Number of replies to return (1-100, default: 100)
cursor: Pagination cursor
format: Response format

Returns: Array of messages in the thread, including the parent message.

{
  "type": "object",
  "required": [
    "channel_id",
    "thread_ts"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "thread_ts": {
      "type": "string",
      "description": "Parent message timestamp"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_create_conversation

Create a new Slack channel.

Args:

name: Channel name (lowercase, no spaces, max 80 chars)
is_private: Whether to create a private channel (default: false)

Returns: The created channel object.

{
  "type": "object",
  "properties": {
    "is_private": {
      "type": "boolean",
      "default": false,
      "description": "Create as private channel"
    }
  }
}

slack_archive_conversation

Archive a Slack channel.

Args:

channel_id: The channel ID to archive

Note: Archived channels can be unarchived later.

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to archive"
    }
  }
}

slack_unarchive_conversation

Unarchive a Slack channel.

Args:

channel_id: The channel ID to unarchive

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to unarchive"
    }
  }
}

slack_rename_conversation

Rename a Slack channel.

Args:

channel_id: The channel ID to rename
name: New channel name

{
  "type": "object",
  "required": [
    "channel_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New channel name"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_set_conversation_topic

Set the topic of a Slack channel.

Args:

channel_id: The channel ID
topic: New topic text

{
  "type": "object",
  "required": [
    "channel_id",
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "New topic"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_set_conversation_purpose

Set the purpose/description of a Slack channel.

Args:

channel_id: The channel ID
purpose: New purpose text

{
  "type": "object",
  "required": [
    "channel_id",
    "purpose"
  ],
  "properties": {
    "purpose": {
      "type": "string",
      "description": "New purpose"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_invite_to_conversation

Invite users to a Slack channel.

Args:

channel_id: The channel ID
user_ids: Comma-separated list of user IDs to invite

{
  "type": "object",
  "required": [
    "channel_id",
    "user_ids"
  ],
  "properties": {
    "user_ids": {
      "type": "string",
      "description": "Comma-separated user IDs"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_kick_from_conversation

Remove a user from a Slack channel.

Args:

channel_id: The channel ID
user_id: User ID to remove

{
  "type": "object",
  "required": [
    "channel_id",
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "User ID to remove"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_join_conversation

Join a public Slack channel.

Args:

channel_id: The channel ID to join

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to join"
    }
  }
}

slack_leave_conversation

Leave a Slack channel.

Args:

channel_id: The channel ID to leave

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to leave"
    }
  }
}

slack_get_conversation_members

Get list of members in a Slack channel.

Args:

channel_id: The channel ID
limit: Number of members to return (1-100, default: 100)
cursor: Pagination cursor
format: Response format

{
  "type": "object",
  "required": [
    "channel_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_get_dnd_info

Get Do Not Disturb status for a user.

Args:

user_id: Optional user ID (defaults to authenticated user)
format: Response format

Returns: DND status, snooze info, and scheduled DND times.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "User ID"
    }
  }
}

slack_add_reaction

Add an emoji reaction to a message.

Args:

channel: Channel ID containing the message
timestamp: Timestamp of the message to react to
name: Emoji name without colons (e.g., 'thumbsup', 'heart')

{
  "type": "object",
  "required": [
    "channel",
    "timestamp",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Emoji name without colons"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_list_files

List files shared in the workspace.

Args:

channel: Filter by channel ID
user: Filter by user ID
types: Filter by file types (comma-separated: images, zips, pdfs, etc.)
ts_from: Files uploaded after this Unix timestamp
ts_to: Files uploaded before this Unix timestamp
limit: Number of files to return (1-100, default: 100)
format: Response format

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Filter by user"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "ts_to": {
      "type": "number",
      "description": "Files before this timestamp"
    },
    "types": {
      "type": "string",
      "description": "Filter by file types"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel": {
      "type": "string",
      "description": "Filter by channel"
    },
    "ts_from": {
      "type": "number",
      "description": "Files after this timestamp"
    }
  }
}

slack_get_file_info

Get detailed information about a specific file.

Args:

file_id: The file ID
format: Response format

Returns: File metadata, sharing info, and preview data.

{
  "type": "object",
  "required": [
    "file_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "file_id": {
      "type": "string",
      "description": "File ID"
    }
  }
}

slack_delete_file

Delete a file from Slack.

Args:

file_id: The file ID to delete

Note: You can only delete files uploaded by your app.

{
  "type": "object",
  "required": [
    "file_id"
  ],
  "properties": {
    "file_id": {
      "type": "string",
      "description": "File ID to delete"
    }
  }
}

slack_upload_file

Upload a file to Slack.

Args:

channels: Channel ID to share the file to
content: Text content of the file
filename: Name of the file
title: Optional title for the file
initial_comment: Optional comment to post with the file
thread_ts: Optional thread to post in

Returns: The uploaded file object.

{
  "type": "object",
  "required": [
    "channels",
    "content",
    "filename"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "File title"
    },
    "content": {
      "type": "string",
      "description": "File content (text)"
    },
    "channels": {
      "type": "string",
      "description": "Channel ID to share to"
    },
    "filename": {
      "type": "string",
      "description": "Filename"
    },
    "thread_ts": {
      "type": "string",
      "description": "Thread timestamp"
    },
    "initial_comment": {
      "type": "string",
      "description": "Comment to post with file"
    }
  }
}

slack_post_message

Send a message to a Slack channel or conversation.

Args:

channel: Channel ID or name to post to
text: Message text (supports Slack markdown/mrkdwn)
thread_ts: Reply to a thread by providing parent message timestamp
reply_broadcast: Also post reply to the channel (default: false)
unfurl_links: Enable URL previews (default: true)
unfurl_media: Enable media previews (default: true)

Returns: The posted message object with timestamp.

{
  "type": "object",
  "required": [
    "channel",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Message text"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID or name"
    },
    "thread_ts": {
      "type": "string",
      "description": "Thread parent timestamp for replies"
    },
    "unfurl_links": {
      "type": "boolean",
      "default": true,
      "description": "Enable URL previews"
    },
    "unfurl_media": {
      "type": "boolean",
      "default": true,
      "description": "Enable media previews"
    },
    "reply_broadcast": {
      "type": "boolean",
      "default": false,
      "description": "Also post to channel"
    }
  }
}

slack_update_message

Update an existing Slack message.

Args:

channel: Channel ID containing the message
ts: Timestamp of the message to update
text: New message text

Note: You can only update messages posted by your app/bot.

{
  "type": "object",
  "required": [
    "channel",
    "ts",
    "text"
  ],
  "properties": {
    "ts": {
      "type": "string",
      "description": "Message timestamp to update"
    },
    "text": {
      "type": "string",
      "description": "New message text"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_delete_message

Delete a Slack message.

Args:

channel: Channel ID containing the message
ts: Timestamp of the message to delete

Note: You can only delete messages posted by your app/bot.

{
  "type": "object",
  "required": [
    "channel",
    "ts"
  ],
  "properties": {
    "ts": {
      "type": "string",
      "description": "Message timestamp to delete"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

slack_schedule_message

Schedule a message to be sent at a future time.

Args:

channel: Channel ID to post to
text: Message text
post_at: Unix timestamp for when to send (up to 120 days in future)
thread_ts: Optional thread to reply to

Returns: Scheduled message ID that can be used to delete before sending.

{
  "type": "object",
  "required": [
    "channel",
    "text",
    "post_at"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Message text"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "post_at": {
      "type": "number",
      "description": "Unix timestamp for when to send"
    },
    "thread_ts": {
      "type": "string",
      "description": "Thread parent timestamp"
    }
  }
}

slack_delete_scheduled_message

Delete a scheduled message before it's sent.

Args:

channel: Channel ID the message was scheduled for
scheduled_message_id: The scheduled message ID

{
  "type": "object",
  "required": [
    "channel",
    "scheduled_message_id"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "scheduled_message_id": {
      "type": "string",
      "description": "Scheduled message ID"
    }
  }
}

slack_list_scheduled_messages

List all scheduled messages.

Args:

channel: Optional channel ID to filter by
limit: Number of messages to return (1-100, default: 100)
cursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel": {
      "type": "string",
      "description": "Filter by channel ID"
    }
  }
}

slack_get_permalink

Get a permanent link to a specific message.

Args:

channel: Channel ID containing the message
message_ts: Timestamp of the message

Returns: A permalink URL that can be shared.

{
  "type": "object",
  "required": [
    "channel",
    "message_ts"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "message_ts": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_remove_reaction

Remove an emoji reaction from a message.

Args:

channel: Channel ID containing the message
timestamp: Timestamp of the message
name: Emoji name to remove

{
  "type": "object",
  "required": [
    "channel",
    "timestamp",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Emoji name without colons"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_get_reactions

Get all reactions on a specific message.

Args:

channel: Channel ID containing the message
timestamp: Timestamp of the message
format: Response format

Returns: Message with all reactions and who reacted.

{
  "type": "object",
  "required": [
    "channel",
    "timestamp"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_list_user_reactions

List items a user has reacted to.

Args:

user_id: Optional user ID (defaults to authenticated user)
limit: Number of items to return (1-100, default: 100)
format: Response format

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "User ID"
    }
  }
}

slack_add_reminder

Create a new reminder.

Args:

text: Reminder text
time: When to send reminder - Unix timestamp, or natural language like "in 20 minutes", "tomorrow at 9am"
user_id: Optional user to remind (defaults to authenticated user)

Returns: The created reminder object.

{
  "type": "object",
  "required": [
    "text",
    "time"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Reminder text"
    },
    "time": {
      "type": "string",
      "description": "When to remind"
    },
    "user_id": {
      "type": "string",
      "description": "User to remind"
    }
  }
}

slack_complete_reminder

Mark a reminder as complete.

Args:

reminder_id: The reminder ID

{
  "type": "object",
  "required": [
    "reminder_id"
  ],
  "properties": {
    "reminder_id": {
      "type": "string",
      "description": "Reminder ID"
    }
  }
}

slack_delete_reminder

Delete a reminder.

Args:

reminder_id: The reminder ID

{
  "type": "object",
  "required": [
    "reminder_id"
  ],
  "properties": {
    "reminder_id": {
      "type": "string",
      "description": "Reminder ID"
    }
  }
}

slack_get_reminder

Get details about a specific reminder.

Args:

reminder_id: The reminder ID
format: Response format

{
  "type": "object",
  "required": [
    "reminder_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "reminder_id": {
      "type": "string",
      "description": "Reminder ID"
    }
  }
}

slack_list_reminders

List all reminders for the authenticated user.

Args:

format: Response format

Returns: List of all reminders.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_search_messages

Search for messages in Slack.

Args:

query: Search query (supports Slack search modifiers like from:, in:, has:, etc.)
sort: Sort by 'score' (relevance) or 'timestamp'
sort_dir: Sort direction 'asc' or 'desc'
count: Number of results to return (1-100, default: 20)
highlight: Include highlighted search terms
format: Response format

Example queries:

"budget report" - Search for these words
"from:@john in:#general" - Messages from John in #general
"has:link after:2024-01-01" - Links posted after date

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "score",
        "timestamp"
      ],
      "type": "string",
      "default": "timestamp"
    },
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "highlight": {
      "type": "boolean",
      "default": false
    }
  }
}

slack_search_files

Search for files in Slack.

Args:

query: Search query
sort: Sort by 'score' (relevance) or 'timestamp'
sort_dir: Sort direction 'asc' or 'desc'
count: Number of results (1-100, default: 20)
highlight: Include highlighted search terms
format: Response format

Example queries:

"Q4 report" - Search for files with these words
"type:pdf" - Only PDF files
"from:@jane type:image" - Images from Jane

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "score",
        "timestamp"
      ],
      "type": "string",
      "default": "timestamp"
    },
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "highlight": {
      "type": "boolean",
      "default": false
    }
  }
}

slack_search_all

Search for both messages and files in Slack.

Args:

query: Search query
sort: Sort by 'score' or 'timestamp'
sort_dir: Sort direction
count: Number of results per type (1-100, default: 20)
format: Response format

Returns: Both message and file results in one response.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "score",
        "timestamp"
      ],
      "type": "string",
      "default": "timestamp"
    },
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    }
  }
}

slack_add_star

Star (save) a message or file.

Args:

channel: Channel ID
timestamp: Message timestamp to star (optional if starring a file)
file_id: File ID to star (optional if starring a message)

Starred items appear in the user's saved items.

{
  "type": "object",
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "file_id": {
      "type": "string",
      "description": "File ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_remove_star

Remove star from a message or file.

Args:

channel: Channel ID
timestamp: Message timestamp (optional if unstarring a file)
file_id: File ID (optional if unstarring a message)

{
  "type": "object",
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel ID"
    },
    "file_id": {
      "type": "string",
      "description": "File ID"
    },
    "timestamp": {
      "type": "string",
      "description": "Message timestamp"
    }
  }
}

slack_list_stars

List starred items for the authenticated user.

Args:

limit: Number of items to return (1-100, default: 100)
format: Response format

Returns: List of starred messages, files, and channels.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_get_team_info

Get information about the Slack workspace.

Args:

format: Response format

Returns: Team name, domain, icon, and enterprise info.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_get_billable_info

Get billing status for users in the workspace.

Args:

user_id: Optional specific user to check
format: Response format

Returns: Billing status for each user.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "Specific user to check"
    }
  }
}

slack_list_usergroups

List all user groups in the workspace.

Args:

include_users: Include user IDs in each group
include_disabled: Include disabled groups
format: Response format

Returns: List of user groups with handles and member counts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "include_users": {
      "type": "boolean",
      "default": false
    },
    "include_disabled": {
      "type": "boolean",
      "default": false
    }
  }
}

slack_create_usergroup

Create a new user group.

Args:

name: Display name for the group
handle: Mention handle (without @)
description: Optional description
channels: Optional comma-separated channel IDs for default channels

Returns: The created user group.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Group display name"
    },
    "handle": {
      "type": "string",
      "description": "Mention handle"
    },
    "channels": {
      "type": "string",
      "description": "Default channel IDs"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

slack_update_usergroup

Update an existing user group.

Args:

usergroup_id: User group ID
name: New display name (optional)
handle: New mention handle (optional)
description: New description (optional)
channels: New default channel IDs (optional)

{
  "type": "object",
  "required": [
    "usergroup_id"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "channels": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "usergroup_id": {
      "type": "string",
      "description": "User group ID"
    }
  }
}

slack_disable_usergroup

Disable a user group.

Args:

usergroup_id: User group ID to disable

{
  "type": "object",
  "required": [
    "usergroup_id"
  ],
  "properties": {
    "usergroup_id": {
      "type": "string",
      "description": "User group ID"
    }
  }
}

slack_enable_usergroup

Enable a disabled user group.

Args:

usergroup_id: User group ID to enable

{
  "type": "object",
  "required": [
    "usergroup_id"
  ],
  "properties": {
    "usergroup_id": {
      "type": "string",
      "description": "User group ID"
    }
  }
}

slack_get_usergroup_members

Get list of users in a user group.

Args:

usergroup_id: User group ID

Returns: List of user IDs.

{
  "type": "object",
  "required": [
    "usergroup_id"
  ],
  "properties": {
    "usergroup_id": {
      "type": "string",
      "description": "User group ID"
    }
  }
}

slack_update_usergroup_members

Replace all members of a user group.

Args:

usergroup_id: User group ID
user_ids: Comma-separated list of user IDs

Note: This replaces all existing members.

{
  "type": "object",
  "required": [
    "usergroup_id",
    "user_ids"
  ],
  "properties": {
    "user_ids": {
      "type": "string",
      "description": "Comma-separated user IDs"
    },
    "usergroup_id": {
      "type": "string",
      "description": "User group ID"
    }
  }
}

slack_list_users

List all users in the Slack workspace.

Args:

limit: Number of users to return (1-100, default: 100)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: User objects with profile info, status, and metadata.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_get_user_info

Get detailed information about a specific user.

Args:

user_id: The user ID (e.g., U1234567890)
format: Response format

Returns: User profile, status, timezone, admin status, and more.

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "User ID"
    }
  }
}

slack_get_user_by_email

Find a user by their email address.

Args:

email: The user's email address
format: Response format

Returns: User object if found.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

slack_get_user_presence

Get the online/away status of a user.

Args:

user_id: The user ID

Returns: Presence status (active/away) and connection info.

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "User ID"
    }
  }
}

slack_set_presence

Set the bot's presence status.

Args:

presence: 'auto' (based on connection) or 'away'

{
  "type": "object",
  "required": [
    "presence"
  ],
  "properties": {
    "presence": {
      "enum": [
        "auto",
        "away"
      ],
      "type": "string",
      "description": "Presence to set"
    }
  }
}

slack_get_user_conversations

List conversations a user is a member of.

Args:

user_id: Optional user ID (defaults to authenticated user)
types: Conversation types to include
exclude_archived: Exclude archived channels
limit: Number to return (1-100, default: 100)
cursor: Pagination cursor
format: Response format

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "types": {
      "type": "string",
      "default": "public_channel,private_channel,mpim,im"
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "user_id": {
      "type": "string",
      "description": "User ID (default: current user)"
    },
    "exclude_archived": {
      "type": "boolean",
      "default": true
    }
  }
}