
Slack MCP Server by korotovsky: Setup for Claude, Cursor and Other Apps
Not the official Slack MCP server. This one is built by the community. Slack makes its own: Slack MCP →
Lets your AI assistant read, search and (if you allow it) post in your Slack channels and DMs.
This community server lets Claude, Cursor and other assistants read your Slack channels, DMs and threads, search messages and manage user groups. It runs on your computer and acts as you, using a Slack user token, a bot token, or the browser session tokens that need no app approval. Posting messages, reactions and file downloads are off until you turn them on. User group and channel join and leave tools are on by default.
Good for
- People who want Claude to catch them up on channels and DMs
- Anyone who cannot get a Slack app approved and needs a user or browser token
- Teams that need GovSlack or Enterprise Slack support
- Admins who manage user groups from the chat
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install slack-mcp-server
Claude Code
- 1
Copy this prompt.
Add the slack-mcp-server server to Claude Code. Run this command: claude mcp add slack -e SLACK_MCP_XOXP_TOKEN=<SLACK_MCP_XOXP_TOKEN> -- npx -y slack-mcp-server@latest --transport stdio Ask me for SLACK_MCP_XOXP_TOKEN and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
The README documents three ways to sign in: SLACK_MCP_XOXP_TOKEN (user token), SLACK_MCP_XOXB_TOKEN (bot token) or SLACK_MCP_XOXC_TOKEN plus SLACK_MCP_XOXD_TOKEN (browser session). Swap the variable in the config if you use another one. To allow posting add SLACK_MCP_ADD_MESSAGE_TOOL, to allow reactions SLACK_MCP_REACTION_TOOL, to allow downloads SLACK_MCP_ATTACHMENT_TOOL, and to allow mark as read SLACK_MCP_MARK_TOOL.
Built from the package data we hold. Not yet tested by us. Source.
Tools
Searches Slack messages with filters
Finds messages by words, channel, person or date. It is not available when you connect with a bot token.
Try: “Find messages from Priya about the launch in the last two weeks.”
Network ·
conversations_search_messagesReads recent messages in a channel or DM
Returns the latest messages from one channel or DM and a cursor to page back through older ones.
Try: “Summarize what happened in #support today.”
Network ·
conversations_historyReads the replies in a thread
Returns every reply under one message.
Try: “Read the thread under the outage announcement.”
Network ·
conversations_repliesLists channels in the workspace
Lists channels by type. On large workspaces this can be thousands of results.
Try: “List the public channels about engineering.”
Network ·
channels_listLists only the channels you belong to
Returns just your own channels, which is shorter on big workspaces.
Try: “Which channels am I in?”
Network ·
channels_meFinds people by name, email or ID
Looks up a person and returns their details and the id of your DM with them if there is one.
Try: “Find Dana's Slack profile.”
Network ·
users_searchLists your unread messages, DMs first
Collects unread messages across channels. With browser tokens it is one complete call; with a user token it scans a limited number of channels and can be partial. Not available with a bot token.
Try: “What did I miss since this morning?”
Network ·
conversations_unreadsLists user groups like @engineering
Shows the mention groups in your workspace and how many people are in each.
Try: “List all Slack user groups.”
Network ·
usergroups_listLists your Save for Later items
Returns the messages you saved. It works only with the xoxc and xoxd browser session tokens.
Try: “Show my saved Slack items.”
Network ·
saved_listPosts a message to a channel or DM
Posts text as you. Off by default: it needs SLACK_MCP_ADD_MESSAGE_TOOL set, and you can limit it to named channels.
Try: “Reply in the #ops thread that I'm on it.”
Write ·
conversations_add_messageAdds an emoji reaction to a message
Reacts to a message as you. Off by default: turn it on with SLACK_MCP_REACTION_TOOL.
Try: “React with a thumbs up to the last message in #releases.”
Write ·
reactions_addRemoves an emoji reaction
Takes away a reaction from a message. Off by default: turn it on with SLACK_MCP_REACTION_TOOL.
Try: “Remove my thumbs up from that message.”
Write ·
reactions_removeDownloads a file attached to a message
Returns the content of a Slack file up to 5 MB. Off by default: turn it on with SLACK_MCP_ATTACHMENT_TOOL.
Try: “Download the CSV attached to the report message.”
Network ·
attachment_get_dataMarks a channel or DM as read
Clears the unread badge for a conversation. The server accepts the call only when SLACK_MCP_MARK_TOOL is set to true or 1.
Try: “Mark #random as read.”
Write ·
conversations_markJoins a public channel
Adds you to a public channel.
Try: “Join #design-reviews.”
Write ·
conversations_joinLeaves a channel or DM
Removes you from a conversation. It is marked destructive.
Try: “Leave the #old-project channel.”
Write ·
conversations_leaveJoins or leaves a user group yourself
Lists your groups, or adds or removes you from one.
Try: “Add me to the @oncall group.”
Write ·
usergroups_meCreates a user group
Makes a new mention group such as @engineering.
Try: “Create a user group called Design with the handle design.”
Write ·
usergroups_createRenames or edits a user group
Changes a group's details but not who is in it.
Try: “Rename the @eng group to Engineering.”
Write ·
usergroups_updateReplaces everyone in a user group
Sets the full member list of a group. Anyone you leave out is removed, so the assistant must pass everyone. It is marked destructive.
Try: “Make the @oncall group just Priya and Sam.”
Write ·
usergroups_users_updateMarks a saved item done or sets a due date
Changes a Save for Later item.
Try: “Mark my first saved item as done.”
Write ·
saved_updateClears all completed Saved items
Removes every completed item from your Save for Later list at once.
Try: “Clear my completed saved items.”
Delete ·
saved_clear_completed
Read from the source code
Permissions
high risk · 6 things to watch
High risk
The assistant acts as you in Slack, and by default it can change user groups, join or leave channels and clear saved items. Register only the tools you need with the tool list setting, and prefer a limited token over browser session tokens.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Browser session tokens act as your whole account
The xoxc and xoxd tokens skip app approval but carry everything you can do in Slack. Prefer an xoxp or xoxb token with limited scopes when you can. github.com
Group and channel changes are on by default
usergroups_users_update replaces a group's whole member list, and conversations_leave removes you from a channel. Use --enabled-tools to register only the tools you want. github.com
saved_clear_completed deletes your completed saved items
It clears every completed item in Save for Later in one call. Leave it out of --enabled-tools if you want to keep them. github.com
Posting is off until you enable it
conversations_add_message posts as you. When you set SLACK_MCP_ADD_MESSAGE_TOOL, list channel IDs so it can only post in those channels. github.com
Your messages go to the AI app
Anything the assistant reads from Slack is sent to the model provider you use. Avoid connecting a workspace with data your company does not allow in AI tools. github.com
A local cache holds your user and channel lists
The server saves them in a cache folder so it starts faster. The path can be changed with SLACK_MCP_USERS_CACHE and SLACK_MCP_CHANNELS_CACHE. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | The --enabled-tools flag registers only the tools you list. Leave out usergroups_create, usergroups_update, usergroups_users_update, conversations_join, conversations_leave, saved_update and saved_clear_completed for a read-only set. |
|---|---|
| Talks to | Slack (slack.com, or slack-gov.com in GovSlack mode) |
| Sign-in and keys | A Slack token in an environment variable: xoxp user token, xoxb bot token, or xoxc and xoxd browser session tokens. User and channel lists are cached in a local file. |
Questions
Is this the official Slack MCP server?
No. It is a community project by korotovsky. Slack publishes its own hosted server; see the Slack MCP page for it.
How is it different from the official Slack server?
This one runs on your machine with your own token, including browser tokens that need no app approval, and supports GovSlack. The official server is hosted by Slack at https://mcp.slack.com/mcp, so there is nothing to run on your machine.
Does it need a Slack app or admin approval?
Not with the xoxc and xoxd browser tokens, which is the main reason people pick it. A user token (xoxp) or bot token (xoxb) needs a Slack app you create.
Can it post messages?
Only if you turn it on. conversations_add_message stays off until you set SLACK_MCP_ADD_MESSAGE_TOOL, and that setting can limit posting to chosen channels.
Can I make it read-only?
Yes, by listing only the read tools with the --enabled-tools flag. By default it also registers tools that change user groups and channel membership.
Does a bot token work?
Partly. Bot tokens only see channels the bot is invited to, and search, unreads and saved items are not available with them.
Does it work in Claude Desktop?
Yes. The README shows a Claude Desktop config for it, and a Cursor installer. The install box carries the same npx command.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
slack-mcp-server- Registry
- npm
- Transport
- stdio, SSE
- Auth
- token in env
- License
- MIT
- Last commit
- Jul 16, 2026
- Open issues
- 43
Other Slack MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com