PlugWiki
slack-mcp-server logo

Slack MCP Server by korotovsky: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpmslack-mcp-serverkorotovsky/slack-mcp-server

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.

Install slack-mcp-server

Claude Code

  1. 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. 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_messages

  • Reads 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_history

  • Reads the replies in a thread

    Returns every reply under one message.

    Try: “Read the thread under the outage announcement.”

    Network · conversations_replies

  • Lists 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_list

  • Lists 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_me

  • Finds 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_search

  • Lists 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_unreads

  • Lists 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_list

  • Lists 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_list

  • Posts 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_message

  • Adds 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_add

  • Removes 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_remove

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

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-onlyThe --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 toSlack (slack.com, or slack-gov.com in GovSlack mode)
Sign-in and keysA 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

GitHubnpmChangelogIssues

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 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.