mcp-slack
mcp-slack lets you inspect Slack channels/messages and post messages through MCP tools.
List all Slack channels accessible by the bot, including channel names, IDs, and topics.
Read the last N messages from a channel (default 20, max 100).
Send a message to a channel with Slack markdown support; this performs an immediate external write, so confirm the destination and content first.
Accepts channel names without
#or public channel IDs beginning withC; other conversation ID types are not fully supported.
Provides tools for listing channels, reading messages, and posting messages to Slack using a bot token.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-slack Read last 20 messages from #announcements"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-slack
MCP server for Slack integration, built with FastMCP. Provides tools for listing channels, reading messages, and posting to Slack.
Channel listing and reading are observational. slack_post_message performs an
external write immediately when invoked, so callers should confirm the resolved
destination and message content before calling it.
Install
pip install -e ".[dev]"Related MCP server: slack-mcp-server
Environment Variables
Variable | Required | Description |
| Yes | Bot User OAuth Token ( |
| No | Current fallback channel when |
Copy .env.example to .env and fill in your values.
Tools
Tool | Description |
| List all channels accessible by the bot |
| Read last N messages from a channel (default: 20, max: 100) |
| Send a message to a channel |
The channel parameter accepts a channel name (without #) or a public-channel
ID beginning with C. Correct handling for other Slack conversation ID types is
tracked in Issue #8.
Slack App Setup
Go to api.slack.com/apps and create a new app
Under OAuth & Permissions, add the required Bot Token Scopes for the tools you want to use:
Tool
Required Bot Scopes
slack_list_channelschannels:read,groups:readslack_read_channelchannels:history,groups:historyslack_post_messagechat:writeNote: Private-channel access requires the corresponding
groups:*scopes and bot membership. Direct-message and multi-party conversation support is not currently implemented; the supported conversation contract is tracked in Issue #8.Install the app to your workspace
Copy the Bot User OAuth Token (
xoxb-...) toSLACK_BOT_TOKENInvite the bot to channels it should access:
/invite @your-bot-name
Troubleshooting: missing_scope Error
If a tool fails with a missing_scope error, it means the bot doesn't have the necessary permissions to perform that action. Check the error message to see which scope is missing, cross-reference it with the table above, and add the missing scope in your Slack App's OAuth & Permissions page. (Remember to reinstall the app to your workspace after changing scopes!)
Usage
Standalone
mcp-slackClaude Desktop config
{
"mcpServers": {
"slack": {
"command": "mcp-slack",
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token"
}
}
}
}Development
pip install -e ".[dev]"
ruff check src/ tests/
ruff format src/ tests/
pytestLicense
MIT
Documentation and roadmap
Priorities live in GitHub Issues and Projects. Delivery history lives in closed Issues, pull requests and GitHub Releases.
Available Tools
3 toolsslack_list_channelsA
List all Slack channels accessible by the bot.
Returns a formatted list of channel names with their IDs and topics.
Inputs: no named parameters. Returns: result
slack_post_messageA
Send a message to a Slack channel.
Args: channel: Channel name (without #) or channel ID. text: The message text to send. Supports Slack markdown.
Inputs: text (required), channel (required). Returns: result
slack_read_channelA
Read the last N messages from a Slack channel.
Args: channel: Channel name (without #) or channel ID. limit: Number of messages to retrieve (default: 20, max: 100).
Inputs: channel (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool maps to a distinct Slack action+resource: listing channels, reading messages, and posting messages. There is no overlap in purpose or argument shape between them.
All three tools use a consistent slack_ prefix with a clear verb_noun pattern (slack_list_channels, slack_read_channel, slack_post_message). The convention is predictable throughout.
Three tools is on the thin side for a Slack integration; the set covers only the most basic read/write loop. It is functional but leaves little room for common adjacent operations.
Core operations (list channels, read messages, post message) are present, but there are notable gaps: no thread replies, reactions, message search, user/DM lookup, or message editing. Agents can do basic workflows but will hit dead ends on common Slack tasks.
Maintenance
Related MCP Connectors
Enable interaction with Slack workspaces. Supports subscribing to Slack events through Resources.
Connect a Discord bot (bot token from the developer portal) to read/send messages, list guilds and c
Chat with your AI agents from Slack: each gets a thread in your DM, and your replies there wake it.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with Slack workspaces as a user, supporting channel listing, message posting, threading, reactions, and user management via the Slack API.811MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Slack workspaces, including listing channels, posting messages, replying to threads, adding reactions, and retrieving user information.1024 npmMIT
- FlicenseAqualityDmaintenanceEnables AI agents to interact with Slack using a user token, providing full access to message search, channel history, DMs, and posting as the user.8-
- AlicenseBqualityBmaintenanceEnables AI assistants to interact with Slack workspaces, providing tools for reading messages, posting content, managing channels, and more.2243MIT