Log inSubmit server
Slack MCP Server logo

Slack MCP Server

Reads Slack channels, threads, users, and searches messages through seven MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Slack MCP Server

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "slack-mcp-server": {
      "command": "uvx",
      "args": [
        "slack-mcp-server-v2"
      ],
      "env": {
        "SLACK_USER_TOKEN": "YOUR_VALUE_HERE",
        "SLACK_BOT_TOKEN": "YOUR_VALUE_HERE",
        "SLACK_WORKSPACE_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx slack-mcp-server-v2

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 9d ago.

Overview

The slack-mcp-server MCP server connects an MCP client to Slack for reading channel messages, threads, channel metadata, user profiles, and conversation search. It runs as a Python package or from source over standard MCP configuration, using a Slack user or bot OAuth token. Use it when an AI assistant needs current Slack context, searchable messages, or links to specific conversations. Access depends on the token scopes and, for bot tokens, the channels where the bot is invited.

Use cases

  • Read recent messages from a Slack channel
  • Inspect complete Slack discussion threads
  • Search conversations involving the authenticated user
  • Look up Slack channel and user metadata
  • Generate permanent links to Slack messages

Key features

  • Read channel messages with time filtering
  • Read parent messages and thread replies
  • Search involved or mentioned conversations
  • List channel, DM, and group-DM memberships
  • Retrieve channel and user metadata
  • Generate Slack message permalinks

Tools9

What Slack MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~86 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 44d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · slack-mcp-server-v2 (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit9mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed9Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Slack MCP Server works

What slack-mcp-server MCP server does

The slack-mcp-server MCP server exposes seven read-oriented Slack operations through MCP. It can retrieve recent messages from a channel, including timestamps, mentions, thread indicators, reactions, and permalinks. A separate thread operation returns the parent message and its replies.

Metadata tools provide channel details such as name, ID, creation date, member count, privacy, topic, and purpose. User lookups return profile fields including names, email, title, status, timezone, and administrator or bot indicators. The server can also enumerate channels the authenticated user belongs to, including public and private channels, direct messages, and group direct messages.

Search is limited to conversations where the authenticated user is mentioned or involved. Results include channel names, user information, timestamps, and permalinks. The final tool creates a permanent Slack link for a specified message.

How it works

The slack-mcp-server MCP server communicates with Slack using OAuth credentials supplied through environment variables. MCP clients start the server either with the published Python package through uvx or with a local server.py installation. The client then exposes the Slack operations to an AI assistant as MCP tools.

Channel and user operations use Slack IDs, such as C1234567890 for a channel or U1234567 for a user. Reading channel messages accepts a lookback period and a result limit, with a maximum of 1,000 messages. Searches accept a query and can return up to 100 results. Thread and permalink operations require Slack timestamps, using the parent message timestamp for threads.

Setup and configuration

Install the package with pip install slack-mcp-server-v2, or run it with uvx slack-mcp-server-v2. Source installation is also available by cloning the repository and installing the dependencies listed in requirements.txt.

Authentication supports either a Slack user token or a bot token. User tokens use the permissions of the associated Slack user. Bot tokens require the bot to be invited to channels it should read. The documented scopes cover channel and private-channel history and metadata, direct-message history and metadata, user information, and message search.

Set SLACK_USER_TOKEN or SLACK_BOT_TOKEN in the environment, along with SLACK_WORKSPACE_URL in the Claude Code configuration. Claude Code loads the server through ~/.claude.json; after restarting, claude mcp list can confirm that the configured server is active.

Tools and capabilities

The available tools are:

  • read_channel_messages: Fetch recent messages with configurable lookback hours and limits.
  • read_thread_messages: Return a parent message and all replies.
  • get_channel_info: Inspect channel metadata and settings.
  • get_user_info: Retrieve a Slack user's profile and status fields.
  • list_my_channels: List memberships by public, private, DM, or group-DM type.
  • search_my_conversations: Search messages involving the authenticated user.
  • get_message_permalink: Produce a permanent link for a message.

The slack-mcp-server MCP server is suited to assistants that need to summarize recent channel activity, inspect a discussion thread, find messages about a topic, identify channel or user metadata, or return a link to a known Slack message.

Limitations and notes

The server's accessible data is controlled by Slack OAuth scopes and the selected token type. A bot cannot read channels unless it has been invited, while a user token accesses channels available to that Slack user. Message retrieval is bounded by the documented limits, and conversation search is scoped to messages where the user is mentioned or involved rather than being described as an unrestricted workspace search.

The provided configuration examples target Claude Code. The repository describes the server as intended for AI assistants such as Claude, but does not document client-specific setup for other MCP clients.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Slack MCP Server

slack-mcp-server is an MCP server that connects AI assistants to a Slack workspace through OAuth tokens. Its main tools read channel messages and threads, search conversations involving the user, list channel memberships, retrieve channel and user information, and generate permanent links to Slack messages.

Install it with `pip install slack-mcp-server-v2` or run `uvx slack-mcp-server-v2`. You can also clone the repository and install its requirements, then configure the server to launch the local `server.py` file.

Authenticate with either `SLACK_USER_TOKEN` or `SLACK_BOT_TOKEN`. Create a Slack app, grant the documented history, read, user, and search scopes, install it in the workspace, and place the resulting OAuth token in the server environment.

Yes. Add the server to `~/.claude.json` with `uvx slack-mcp-server-v2` or a local Python command, provide the Slack token and workspace URL, restart Claude Code, and verify it with `claude mcp list`.

Yes, when the token has the required private-channel permissions and access. User tokens can access private channels available to that user; bot tokens require the bot to be invited to the channels they need to read.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSlack MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/slack-mcp-server?style=directory)](https://allmcps.com/mcp/slack-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/slack-mcp-server"><img src="https://allmcps.com/api/badge/slack-mcp-server?style=directory" alt="Slack MCP Server on AllMCPs" /></a>