Skip to content
ToolCargo

Slack MCP server

Live

Read Slack conversations and messages with your bot token.

Bring your own Slack bot token to list accessible conversations, read channel details and bounded message history, read message thread replies and resolve user names. Read-only. Needs your credentials; bot membership and granted scopes restrict access.

Slack is a hosted MCP server with 5 tools. The Claude Code command is on this page. Steps for Cursor and ChatGPT, and which clients we have tested, are in the client guides.

Connect / 5 tools

Server URL

streamable http
https://toolcargo.com/mcp/slack

Claude Code

terminal
claude mcp add --transport http --scope user toolcargo-slack https://toolcargo.com/mcp/slack \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

  • Find accessible channels
  • Summarize message history from channels the bot belongs to
  • Resolve message authors without exposing emails

Built for: Teams with a Slack workspace and an installed bot app.

Example requests

Channel catch-up

“With ToolCargo Slack, summarize recent messages in the channel our bot belongs to.”

One bounded page of messages with author IDs and timestamps, subject to Slack access and retention.

Explore useful agent workflows ↗

Tools

ToolWhat it doesAccess
slack_list_conversations
List Slack conversations
One page of conversations visible to your bot token, filtered by type. channels:read for public channels; groups:read, im:read or mpim:read for other types. Listing a channel does not imply the bot can read its history.Read-only
slack_conversation_info
Read Slack conversation details
Read a conversation's name, topic, purpose, membership and archive status. Requires the relevant read scope and token access.Read-only
slack_conversation_history
Read Slack messages
One page of at most 15 message text records in a conversation the bot belongs to. Requires channels:history, groups:history, im:history or mpim:history for its type. Optional oldest/latest Slack timestamps; no attachments or files.Read-only
slack_thread_replies
Read Slack message thread
Parent and replies for an accessible conversation thread, at most 15 messages. Requires the relevant channels:history, groups:history, im:history or mpim:history scope; bot access and membership restrictions apply.Read-only
slack_user_info
Read Slack user name
Resolve a Slack user ID to a name, display name, timezone and bot/deactivated status. Requires users:read; email, phone and custom profile fields are not returned.Read-only

Requirements

  • • A ToolCargo account with Site Audit activated (free).
  • • Your existing Slack app's xoxb bot token with channels:read; add channels:history for public message history. Connect at /slack.
  • • Invite the bot to the channels you want to read. Additional read scopes are documented at /docs/slack.

Limitations

  • • No messages sent, edited or deleted; no app creation or channel joining.
  • • History and thread replies require the matching conversation history scope and bot access; workspace policies may restrict results.
  • • One page per call: history/replies max 15, conversations max 100. Slack rate limits and retention apply.
  • • Emails, phone numbers, attachments, files and custom profile fields are omitted.
  • • Token is encrypted per owner and deleted on disconnect. Real Slack account acceptance needs your credentials.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. Recorded client-specific tests currently cover Site Audit. Other connectors use the documented setup until tested in that client.

Claude CodeAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
Claude (claude.ai)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
CursorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
VS Code (Copilot agent mode)API key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
ChatGPT (developer mode)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
MCP InspectorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.

Pricing

Included with Site Audit. Each successful Slack tool call uses one shared plan call. No paid proxy API.

Free

$0

Try hosted tools with a shared monthly allowance.

50 shared calls/month

Pro

$12/mo

Proposed larger shared allowance; see checkout status on the pricing page.

2,000 shared calls/month

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details