MCP Adapter for Slack Communication Hub

A complete implementation of the Model Context Protocol (MCP) server specifically engineered for bridging AI agents with Slack platforms.

Overview

This module furnishes an MCP endpoint allowing sophisticated AI entities to execute various operations within connected Slack workspaces. Key capabilities include:

Enumerating and browsing available channels
Dispatching new messages to specified channels
Providing replies within existing discussion threads
Applying standardized or custom emoji reactions to posted items
Fetching chronological message archives from channels
Querying the replies nested within a specific thread
Obtaining directory listings for workspace members and retrieving individual user profiles

Setup Instructions

# Install via Node Package Manager
npm install shouting-mcp-slack

# Alternatively, install globally for system-wide access
npm install -g shouting-mcp-slack

The package is accessible on the npm registry here: shouting-mcp-slack

Prerequisites

Before deployment, configuration of a Slack Bot application and acquisition of necessary authentication credentials are required:

Establish a new Slack Application via the Slack API Console.
Ensure the following Bot Token Scopes are granted to the application:
channels:history
channels:read
chat:write
reactions:write
users:read
users:read.email
Authorize and install this new application into your target workspace.
Securely copy the resulting Bot User OAuth Token.

Configuration Parameters

The server instantiation mandates the presence of these environment variables:

SLACK_BOT_TOKEN: The copied Slack Bot User OAuth Token.
SLACK_TEAM_ID: The identifier corresponding to your Slack Team.

Execution Guide

Command Line Interface (CLI) Execution

# Set required environment configuration variables
export SLACK_BOT_TOKEN=xoxb-your-secret-token
export SLACK_TEAM_ID=T12345ABCDE

# Launch the MCP server instance
mcp-server-slack

Programmatic Integration (Code Usage)

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { SlackClient } from "shouting-mcp-slack";

// Instantiate the primary server context and the specialized Slack client
const server = new Server({...});
const slackClient = new SlackClient(process.env.SLACK_BOT_TOKEN);

// Define and register custom processing handlers here
// ...

Provided Toolset

This integration exposes the following specific tools for AI agent invocation:

slack_list_channels: Utility for retrieving a catalog of all workspace channels.
slack_post_message: Functionality to disseminate new messages into a channel.
slack_reply_to_thread: Mechanism for appending responses directly into discussion threads.
slack_add_reaction: Capability to attach emoji feedback to any given message.
slack_get_channel_history: Accessor for historical message logs within a channel context.
slack_get_thread_replies: Method to fetch all associated messages within a thread structure.
slack_get_users: Tool to list all registered members of the workspace.
slack_get_user_profile: Function to retrieve detailed profile information for a specific user ID.