Get the FREE Ultimate OpenClaw Setup Guide →

slack

Fork of korotovsky/slack-mcp-server with saved_list and saved_complete tools for Slack Save for Later

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio lazallen-slack-mcp-server npx -y slack-mcp-server \
  --env SLACK_MCP_ADD_MESSAGE_TOOL="Enable the conversations_add_message tool. Optional: provide a comma-separated list of channel_ids to restrict posting to specific channels."

How to use

This MCP server provides a Slack integration that can operate over multiple transports (Stdio, SSE, and HTTP) and can route outgoing requests through a proxy if needed. It supports Slack workspace interactions including direct messages, group DMs, channels, and threads, with capabilities such as smart history fetch, message search, and embedded user information. By default, the server runs in a safe mode where the tool to post messages (conversations_add_message) is disabled; you can enable it via an environment variable if you need to post messages to channels or DMs. The tooling set includes conversations_history for retrieving messages, conversations_replies for thread histories, conversations_search_messages for flexible looking, and conversations_add_message for posting (when enabled). The server exposes these tools through the MCP interface and can be consumed by clients via Stdio, SSE, or HTTP transports depending on your setup.

How to install

Prerequisites:

  • Node.js and npm (or npx) installed on your machine
  • Access to the internet to fetch the MCP server package

Option A – Run with npx (recommended):

  1. Ensure you have npx available: npm i -g npm
  2. Run the MCP Slack server via npx: npx -y slack-mcp-server

Option B – Install locally with npm:

  1. Initialize a project (if needed): mkdir my-slack-mcp && cd my-slack-mcp npm init -y
  2. Install the Slack MCP server package: npm install slack-mcp-server
  3. Run the server (adjust the path if necessary): npx slack-mcp-server

Notes:

  • You can customize environment variables as described in the documentation (e.g., enable add_message with SLACK_MCP_ADD_MESSAGE_TOOL).
  • If you plan to deploy behind a proxy or in OAuth/stealth modes, ensure your environment is configured accordingly.

Additional notes

Tips and common issues:

  • If you enable conversations_add_message, provide a restricted list of channel_ids to limit posting risks or leave it unset to allow posting everywhere.
  • When using SSE/HTTP transports, ensure your MCP client supports the chosen transport and tokens/scopes align with Slack permissions.
  • The server caches user and channel information to speed up responses; if you notice stale data, consider refreshing cache by restarting the server.
  • Review your Slack app permissions and OAuth mode vs stealth mode to match your deployment needs.
  • For debugging, start the server with verbose logging if available in your version of the package, and verify that environment variables are picked up by the process.

Related MCP Servers

Sponsor this space

Reach thousands of developers