
How to add Slack MCP Server (Ubie) to Claude Desktop
Bot-token Slack MCP for posting, reading channels and searching messages Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 15, 2026 ยท 110โ ยท stdio ยท apikey
Claude Desktop config for Slack MCP Server (Ubie)
npx -y @ubie-oss/slack-mcp-server{
"mcpServers": {
"slack-mcp-server-ubie": {
"command": "npx",
"args": [
"-y",
"@ubie-oss/slack-mcp-server"
],
"env": {
"SLACK_BOT_TOKEN": "<your-slack-bot-token-xoxb>",
"SLACK_USER_TOKEN": "<your-slack-user-token-xoxp>"
}
}
}
}Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Slack MCP Server (Ubie) config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Slack MCP Server (Ubie)'s tools appear under the ๐ tools menu.
Before you start
- Node.js (version pinned in the repo's .node-version file)
- A Slack app installed to your workspace with a Bot User OAuth token (SLACK_BOT_TOKEN), with scopes for the actions you need (e.g. channels:read, chat:write, reactions:write, users:read)
- A Slack User OAuth token (SLACK_USER_TOKEN) with search:read โ required only for the message search tool
- A GitHub Personal Access Token with read:packages scope plus an .npmrc, since the package is hosted on the GitHub Packages registry (not public npm)
What Slack MCP Server (Ubie) can do in Claude Desktop
slack_list_channelsList public channels in the workspace, with pagination support
slack_post_messagePost a new message to a Slack channel
slack_reply_to_threadReply within an existing message thread
slack_add_reactionAdd an emoji reaction to a message
slack_get_channel_historyRetrieve recent messages from a channel
slack_get_thread_repliesGet all replies in a thread
slack_get_usersRetrieve basic user profile information
slack_get_user_profilesBulk-retrieve user profile information
Security
Requires a Slack bot token with broad scopes; grant only the scopes you need and set SLACK_SAFE_SEARCH=true to exclude private channels, DMs and group DMs from search results.
Slack MCP Server (Ubie) + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Slack MCP Server (Ubie) config there under the "mcpServers" key and restart the client.
Is Slack MCP Server (Ubie) safe to use with Claude Desktop?
Requires a Slack bot token with broad scopes; grant only the scopes you need and set SLACK_SAFE_SEARCH=true to exclude private channels, DMs and group DMs from search results.
Why does npm install fail for @ubie-oss/slack-mcp-server?
The package is published to the GitHub Packages registry, not public npm. You need a GitHub Personal Access Token with read:packages and an .npmrc mapping the @ubie-oss scope to npm.pkg.github.com.
Do I need a Slack user token, or is the bot token enough?
The bot token (SLACK_BOT_TOKEN) covers posting, reading, reactions, and user lookups. The slack_search_messages tool additionally requires a User OAuth token (SLACK_USER_TOKEN) with the search:read scope.
Can it run over HTTP instead of stdio?
Yes. By default it speaks stdio for local MCP clients, but you can start it as an HTTP server by passing a port, e.g. `npx @ubie-oss/slack-mcp-server -port 3000`.