MCP Server for Slack

by z9905080
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides distribution of the MCP server package through the npm registry, allowing users to install and use the server for Slack integration.

  • Displays dynamic version badge for the package in the README, showing current npm version information.

  • Enables AI assistants to interact with Slack workspaces by listing channels, sending messages, replying to threads, adding reactions, retrieving channel history, getting thread replies, and accessing user information.

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

shouting.hsiao@gmail.com

Repository

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

-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server implementation that enables AI assistants to interact with Slack workspaces, allowing them to browse channels, send messages, reply to threads, add reactions, and retrieve user information.

  1. Overview
    1. Installation
      1. Prerequisites
        1. Configuration
          1. Usage
            1. Running as a CLI Tool
            2. Using in Your Code
          2. Available Tools
            1. License
              1. Author
                1. Repository