Slack MCP server
LiveRead 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
https://toolcargo.com/mcp/slackClaude Code
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.
Tools
| Tool | What it does | Access |
|---|---|---|
slack_list_conversationsList 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_infoRead 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_historyRead 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_repliesRead 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_infoRead 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 Code | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| Claude (claude.ai) | OAuth sign-in | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| Cursor | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| VS Code (Copilot agent mode) | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| ChatGPT (developer mode) | OAuth sign-in | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
| MCP Inspector | API key header | Documented, not yet tested | This endpoint has not yet been tested in this client. See the setup guide. |
More in Messaging
- Calendly LiveEvent types and scheduled meetings from your Calendly account.
- GmailTesting onlyTesting only: search and read your own Gmail with BYO OAuth credentials.
- Google CalendarTesting onlyTesting only: read calendars, events and busy intervals with BYO OAuth.
- Mailchimp LiveAudiences, campaigns and campaign reports from Mailchimp.
Pricing
Included with Site Audit. Each successful Slack tool call uses one shared plan call. No paid proxy API.
Free
$0Try hosted tools with a shared monthly allowance.
50 shared calls/month
Pro
$12/moProposed 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.