Lets an AI client read channels and threads, post and update messages, reply in threads, react, and upload snippets in Slack.
Also known as pulsemcp/mcp-servers, slack-workspace-mcp-server
- Stars
- 81
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 0.0.7
- Last commit
- Oct 9, 2026
- License
- MIT
What is Slack MCP?
Slack lets an AI client read channels and threads, post and update messages, reply in threads, react, and upload snippets in Slack. It exposes 10 tools, such as slack_get_channels, slack_get_channel, slack_get_thread.
Summary generated from the project's README
About Slack MCP server
Interacting with Slack workspaces directly from an AI client allows you to manage communications without switching applications. This server enables users to browse public and private channels, read recent messages, and follow entire threaded conversations. It is designed for developers and teams who want to automate or assist with workspace management through an MCP-compatible client like Claude Desktop.
To use this server, you must provide a Slack Bot User OAuth Token starting with xoxb- via the SLACK_BOT_TOKEN environment variable. The setup requires Node.js to run the server using npx. You can restrict the AI's capabilities by configuring the ENABLED_TOOLGROUPS variable to either readonly or write mode. While the readonly group allows for fetching channel info and messages, the write group enables active participation through tools like slack_post_message, slack_reply_to_thread, and slack_upload_snippet for long text content.
What you can do with it
- 1Monitor channel activityAsk the AI to summarize recent discussions from a specific public or private channel.
- 2Manage threaded conversationsHave the AI follow a specific discussion by retrieving all replies within a thread.
- 3Share long-form documentationUse the AI to upload large blocks of text as file snippets when they exceed standard message limits.
Written from the project's README. Every use case is checked against a quote from it.
How to install Slack MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Slack MCP in Claude Code
$ claude mcp add --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' slack -- npx -y slack-workspace-mcp-serverInstall Slack MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": [
"-y",
"slack-workspace-mcp-server"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Slack MCP in VS Code
.vscode/mcp.json
{
"servers": {
"slack": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"slack-workspace-mcp-server"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Slack MCP in VS Code CLI
$ code --add-mcp '{"name":"slack","type":"stdio","command":"npx","args":["-y","slack-workspace-mcp-server"],"env":{"SLACK_BOT_TOKEN":"<YOUR_SLACK_BOT_TOKEN>"}}'Install Slack MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": [
"-y",
"slack-workspace-mcp-server"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Slack MCP in Codex
$ codex mcp add slack --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' -- npx -y slack-workspace-mcp-serverInstall Slack MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.slack] command = "npx" args = ["-y", "slack-workspace-mcp-server"] [mcp_servers.slack.env] SLACK_BOT_TOKEN = "<YOUR_SLACK_BOT_TOKEN>"
Install Slack MCP in Gemini CLI
$ gemini mcp add -s user -e 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' slack npx -- -y slack-workspace-mcp-serverInstall Slack MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": [
"-y",
"slack-workspace-mcp-server"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Slack MCP tools 10
Detected from the READMEslack_get_channelsslack_get_channelslack_get_threadslack_post_messageslack_reply_to_threadslack_update_messageslack_react_to_messageslack_upload_snippetreadonlywrite
| slack_get_channels | — | |
| slack_get_channel | — | |
| slack_get_thread | — | |
| slack_post_message | — | |
| slack_reply_to_thread | — | |
| slack_update_message | — | |
| slack_react_to_message | — | |
| slack_upload_snippet | — | |
| readonly | — | |
| write | — |
Configuration
SLACK_BOT_TOKENRequiredSecretSlack Bot User OAuth Token starting with xoxb-.
ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly, write).
| Name | Description | |
|---|---|---|
| SLACK_BOT_TOKEN | Slack Bot User OAuth Token starting with xoxb-. | RequiredSecret |
| ENABLED_TOOLGROUPS | Comma-separated list of tool groups to enable (readonly, write). |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubSlack MCP Server
A Model Context Protocol (MCP) server for integrating with Slack workspaces. This server provides tools for reading and writing messages, managing threads, and reacting to messages in Slack.
Features
- List Channels - View all accessible public and private channels
- Read Channel - Get channel info and recent messages
- Read Threads - Get full threaded conversations
- Post Messages - Send new messages to channels
- Reply to Threads - Continue threaded conversations
- Update Messages - Edit previously posted messages
- React to Messages - Add emoji reactions to messages
- Upload Snippets - Upload text content as file snippets (for long content that exceeds message limits)
Setup
Prerequisites
- A Slack workspace with admin permissions to create apps
- A Slack Bot Token (see instructions below)
Environment Variables
| Variable | Required | Description | Default |
|---|---|---|---|
SLACK_BOT_TOKEN |
Yes | Slack Bot User OAuth Token | - |
ENABLED_TOOLGROUPS |
No | Comma-separated list of tool groups | All enabled |
Getting a Bot Token
- Go to api.slack.com/apps
- Create a new app or select an existing one
- Navigate to OAuth & Permissions
- Add the following Bot Token Scopes:
channels:read- View basic channel informationchannels:history- View messages in public channelsgroups:read- View private channelsgroups:history- View messages in private channelschat:write- Send messagesreactions:write- Add reactionsfiles:write- Upload files and snippets
- Install the app to your workspace
- Copy the Bot User OAuth Token (starts with
xoxb-)
Claude Desktop
Make sure you have your Slack Bot Token ready.
Then proceed to the setup instructions below. If this is your first time using MCP Servers, you'll want to make sure you have the Claude Desktop application and follow the official MCP setup instructions.
Manual Setup
You're going to need Node working on your machine so you can run npx commands in your terminal. If you don't have Node, you can install it from nodejs.org.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Modify your claude_desktop_config.json file to add the following:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "slack-workspace-mcp-server"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token-here"
}
}
}
}
Restart Claude Desktop and you should be ready to go!
Available Tools
Read-Only Tools
| Tool | Description |
|---|---|
slack_get_channels |
List all accessible channels |
slack_get_channel |
Get channel info with recent messages |
slack_get_thread |
Get a thread with all replies |
Write Tools
| Tool | Description |
|---|---|
slack_post_message |
Post a new message to a channel |
slack_reply_to_thread |
Reply to an existing thread |
slack_update_message |
Update a previously posted message |
slack_react_to_message |
Add an emoji reaction to a message |
slack_upload_snippet |
Upload text content as a file snippet to a channel |
Tool Groups
You can control which tools are available using the ENABLED_TOOLGROUPS environment variable:
readonly- Only read operations (get channels, messages, threads)write- All operations including posting and reactions
Example: ENABLED_TOOLGROUPS=readonly to disable all write operations.
Development
# Install dependencies
npm run install-all
# Run in development mode
npm run dev
# Run tests
npm test # Functional tests
npm run test:integration # Integration tests
npm run test:manual # Manual tests (requires real credentials)
# Build
npm run build
License
MIT
Slack MCP questions
How do I add Slack MCP to Claude Code?
Run claude mcp add --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' slack -- npx -y slack-workspace-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Slack MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Slack MCP provide?
It exposes 10 tools, including slack_get_channels, slack_get_channel, slack_get_thread, slack_post_message, slack_reply_to_thread.
How do I authenticate the Slack MCP server?
It uses a Slack Bot User OAuth Token supplied via the SLACK_BOT_TOKEN environment variable; the token starts with xoxb-.
Can the Slack MCP server post messages and reply in threads?
Yes, it can post new messages to channels, reply to existing threads, update posted messages, and add emoji reactions.
How do I make the Slack MCP server read-only?
Set the ENABLED_TOOLGROUPS environment variable to readonly to disable all write operations.
Can the Slack MCP server upload long content?
Yes, it can upload text content as a file snippet for content that exceeds message limits.
Which Slack bot scopes does the server require?
It requires scopes such as channels:read, channels:history, groups:read, groups:history, chat:write, reactions:write, and files:write.