Kimpalbok Slack

Provides an MCP server to manage Slack workspace channels, messages, reactions, and user profiles via HTTP/stdio transport.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 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": {
    "dev-palboksoft-kimpalbok-slack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kimpalbok-slack-mcp-server"
      ],
      "env": {
        "SLACK_TEAM_ID": "T12345678",
        "SLACK_BOT_TOKEN": "xoxb-...",
        "SLACK_CHANNEL_IDS": "C12345678,C23456789"
      }
    }
  }
}

You run this MCP server to bridge Slack workspace data with MCP clients. It enables querying channels, posting messages, replying in threads, reacting to messages, retrieving histories, and fetching user profiles through a standardized, transport-agnostic API.

How to use

You connect an MCP client to the Slack MCP Server using the stdio configuration provided. The server exposes tools that let you list channels, post messages, reply in threads, add reactions, fetch channel history and thread replies, and retrieve user information. Use the client to invoke these tools and handle responses in your application flow.

Typical usage patterns include: listing available channels to select targets, sending messages to a channel or thread, reacting to messages to signal status, and querying user profiles for display in your app. Each action is exposed as an MCP tool with a clear input/output contract, so you can compose higher-level workflows without directly dealing with Slack’s API details.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Create a project directory for the MCP server and navigate into it.
Install and run the MCP server as shown in the configuration example.
Set the required environment variables before starting the server.

{
  "mcpServers": {
    "kimpalbok-slack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kimpalbok-slack-mcp-server"
      ]
    },
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-...",
      "SLACK_TEAM_ID": "T12345678"
    }
  }
}

Additional notes

Environment variables you must set before running the server include the Slack bot token and the Slack team ID. Optionally, you can specify a comma-separated list of predefined channel IDs to limit the channels exposed by the server.

Slack bot setup requires creating a Slack app with appropriate bot scopes and generating a Bot User OAuth Token. Ensure the token has permissions necessary to read channels, post messages, and manage reactions.

Available tools

slack_list_channels

Retrieve the list of public or predefined channels in the workspace.

slack_post_message

Post a new message to a channel.

slack_reply_to_thread

Post a reply to a specific message thread.

slack_add_reaction

Add an emoji reaction to a message.

slack_get_channel_history

Fetch recent messages from a channel.

slack_get_thread_replies

Fetch all replies in a thread.

slack_get_users

Retrieve all users and basic profile information in the workspace.

slack_get_user_profile

Fetch detailed profile information for a specific user.

Built by

VeilStrat

AI signals for GTM teams