MCP Slack Server

Provides an MCP server that connects AI assistants with Slack workspaces to list channels, post messages, reply to threads, get history, and retrieve user profiles.

javascript

2

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "z9905080-mcp-slack": {
      "command": "mcp-server-slack",
      "args": [],
      "env": {
        "SLACK_TEAM_ID": "YOUR_TEAM_ID_PLACEHOLDER",
        "SLACK_BOT_TOKEN": "YOUR_SLACK_BOT_TOKEN_PLACEHOLDER"
      }
    }
  }
}

You can run an MCP server that connects AI assistants to a Slack workspace, enabling you to browse channels, post messages, reply in threads, add reactions, retrieve history, and manage user profiles directly from your models. This turns Slack into an actionable data source and interaction target for your AI workflows.

How to use

Set up your MCP Slack server and connect it to your MCP client to perform practical actions in Slack. You can list channels, post messages to a channel, reply to specific threads, add reactions to messages, fetch channel history, retrieve thread replies, and get user profiles. Use these capabilities to build assistants that navigate and interact with your Slack workspace as part of your workflows.

How to install

Prerequisites you need before installation:
- Node.js and npm installed on your machine
- A Slack App with the required bot token scopes (channels:history, channels:read, chat:write, reactions:write, users:read, users:read.email) and a Bot User OAuth Token
- A Slack team ID for your workspace

Install the MCP Slack server package from npm and install it for your environment.

# Install from npm
npm install shouting-mcp-slack

# Or install globally
npm install -g shouting-mcp-slack

# Optional: verify installation by listing the package version
npx shouting-mcp-slack --version

Configuration and running the server

Configure the required environment variables for your Slack connection and team identification. Then start the MCP Slack server using its CLI command.

export SLACK_BOT_TOKEN=xoxb-your-token
export SLACK_TEAM_ID=your-team-id

# Run the server
mcp-server-slack

Available tools

slack_list_channels

List available channels in the Slack workspace.

slack_post_message

Post a message to a specified Slack channel.

slack_reply_to_thread

Reply within an existing Slack thread.

slack_add_reaction

Add a reaction to a Slack message.

slack_get_channel_history

Retrieve message history from a channel.

slack_get_thread_replies

Fetch replies within a thread.

slack_get_users

List users in the workspace.

slack_get_user_profile

Get a user's profile information.