Slack MCP Server logo

Slack MCP Server

by AIAtrium

The Slack MCP Server enables Claude to interact with Slack workspaces by using a user token instead of a bot token. This allows for a wider range of use cases, such as reading direct messages and sending messages on behalf of a user.

View on GitHub

Last updated: N/A

What is Slack MCP Server?

The Slack MCP Server is a server that allows Claude to interact with Slack workspaces. It uses the Slack API and a user token to enable functionalities like listing channels, posting messages, replying to threads, adding reactions, retrieving channel history, getting thread replies, and fetching user information.

How to use Slack MCP Server?

To use the server, you need to create a Slack app, configure user token scopes, install the app to your workspace, and obtain the User OAuth Token. Then, configure the MCP server in your claude_desktop_config.json using either NPX or Docker, providing the Slack user token as an environment variable.

Key features of Slack MCP Server

  • List Slack channels

  • Post messages to Slack channels

  • Reply to Slack message threads

  • Add reactions to Slack messages

  • Retrieve channel history

  • Get replies to a thread

  • Get workspace user list

  • Get user profile information

Use cases of Slack MCP Server

  • Automating Slack communication with Claude

  • Integrating Slack with other applications using Claude as an intermediary

  • Analyzing Slack channel history using Claude

  • Building Slack bots powered by Claude

FAQ from Slack MCP Server

What is a User OAuth Token and where do I find it?

The User OAuth Token is a token that allows the MCP server to act on behalf of a user in Slack. You can find it after installing your Slack app to your workspace under the 'OAuth & Permissions' section.

What scopes are required for the User OAuth Token?

The required scopes include channels:history, channels:read, chat:write, reactions:write, users:read, users.profile:read, groups:history, groups:read, groups:write, im:history, im:read, im:write, mpim:history, mpim:read, and mpim:write.

How do I troubleshoot permission errors?

Verify that all required scopes are added to your Slack app, the app is properly installed to your workspace, and the tokens and workspace ID are correctly copied to your configuration. Also, ensure the app has been added to the channels it needs to access.

Can I use a bot token instead of a user token?

This server is specifically designed to use a user token. While the original server used a bot token, this fork swaps to user token for wider use cases.

What is the license for this MCP server?

This MCP server is licensed under the MIT License, allowing you to use, modify, and distribute the software subject to the terms and conditions of the license.