home / mcp / slack mcp server

Slack MCP Server

Provides access to Slack workspace data via search and retrieval tools (users, channels, messages, threads).

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "takuya0206-slack_search_function_mcp": {
      "command": "./dist/slack_search_function_mcp",
      "args": [],
      "env": {
        "SLACK_TOKEN": "xoxb-your-token-here"
      }
    }
  }
}

This MCP server gives you access to Slack workspace data by exposing tools to search and retrieve users, channels, messages, and thread replies. Use it with an MCP-enabled client to build powerful chat assistants that can explore Slack content on demand.

How to use

You connect your MCP-enabled client to the Slack Search MCP Server to perform actions like listing users, listing channels, fetching channel messages, retrieving thread replies, and searching messages. The server uses a Slack API token you provide as an environment variable. Start the server, then issue tool calls from your client by name and pass any required arguments. You can also navigate all users and channels quickly through the built-in resource endpoints.

How to install

Prerequisites you need before installing this server are the Bun runtime and a Slack API token with appropriate permissions.

Step by step commands to set up and run the server locally:

# Install dependencies
bun install

# Set your Slack API token as an environment variable
export SLACK_TOKEN=xoxb-your-token-here

# Run the server (development via TypeScript source)
bun run index.ts

# Or run the compiled executable after building
./dist/slack_search_function_mcp

Additional sections

Configuration and runtime notes help you tailor the server to your environment and security requirements.

Security is important: the Slack API token is never logged or exposed in responses, and the token should be passed securely through environment variables.

Available tools

get_users

Retrieve a list of users in the Slack workspace, with optional limits to control how many users are returned.

get_channels

Retrieve a list of channels in the Slack workspace, with options to limit results and exclude archived channels.

get_channel_messages

Fetch messages from a specific channel, allowing you to paginate or limit the number of messages returned.

get_thread_replies

Get replies within a specific thread in a channel, enabling threaded conversation retrieval.

search_messages

Search Slack messages with a query string and optional sorting and paging parameters.