What is Mcp Slack

mcp-slack is a Model Context Protocol (MCP) server implementation designed to integrate AI assistants with Slack workspaces, enabling seamless interaction between AI models and Slack functionalities.

Use cases

Use cases for mcp-slack include automating responses in Slack channels, integrating AI-driven chatbots for customer support, managing team communications, and enhancing productivity through AI assistance.

How to use

To use mcp-slack, install it via npm, set up a Slack Bot with the necessary credentials, configure environment variables, and run the server either as a CLI tool or within your code by initializing the server and Slack client.

Key features

Key features of mcp-slack include the ability to list and browse channels, send messages, reply to threads, add reactions, retrieve channel history, get thread replies, and list users with their profiles.

Where to use

mcp-slack can be used in various fields where Slack is utilized for communication and collaboration, such as corporate environments, project management, customer support, and team collaboration.

MCP Server for Slack

A Model Context Protocol (MCP) server implementation for integrating AI assistants with Slack workspaces.

Overview

This package provides an MCP server that enables AI assistants to interact with Slack workspaces. It allows AI models to:

• List and browse channels
• Send messages to channels
• Reply to threads
• Add reactions to messages
• Retrieve channel history
• Get thread replies
• List users and retrieve user profiles

Installation

# Install from npm
npm install shouting-mcp-slack

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

You can find the package on npm: shouting-mcp-slack

Prerequisites

You need to set up a Slack Bot and obtain the necessary credentials:

1. Create a Slack App in the Slack API Console
2. Add the following Bot Token Scopes:
   • channels:history
   • channels:read
   • chat:write
   • reactions:write
   • users:read
   • users:read.email
3. Install the app to your workspace
4. Copy the Bot User OAuth Token

Configuration

The server requires the following environment variables:

• SLACK_BOT_TOKEN: Your Slack Bot User OAuth Token
• SLACK_TEAM_ID: Your Slack Team ID

Usage

Running as a CLI Tool

# Set environment variables
export SLACK_BOT_TOKEN=xoxb-your-token
export SLACK_TEAM_ID=your-team-id

# Run the server
mcp-server-slack

Using in Your Code

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

// Initialize the server and client
const server = new Server({...});
const slackClient = new SlackClient(process.env.SLACK_BOT_TOKEN);

// Register your custom handlers
// ...

Available Tools

The server provides the following Slack integration tools:

• slack_list_channels: List available channels
• slack_post_message: Send a message to a channel
• slack_reply_to_thread: Reply to a thread
• slack_add_reaction: Add a reaction to a message
• slack_get_channel_history: Get message history from a channel
• slack_get_thread_replies: Get replies in a thread
• slack_get_users: List users in the workspace
• slack_get_user_profile: Get a user’s profile

License

ISC

Author

[email protected]

Repository

https://github.com/z9905080/mcp-slack