slack

This MCP server provides a session-based bridge between your Slack workspace and Claude/MCP clients. It mirrors your Slack session locally or hosts an HTTP endpoint, enabling MCP tools to read messages, export conversations, search, and send messages without exposing your credentials beyond the secure flow. The server exposes a suite of Slack-specific MCP tools including slack_health_check, slack_token_status, slack_refresh_tokens, slack_list_conversations, slack_conversations_history, slack_get_full_conversation, slack_search_messages, slack_send_message, slack_get_thread, slack_users_info, and slack_list_users. You can run the server via npx to launch the interactive setup and then use the included tools to verify credentials, inspect workspace data, and perform message operations. For hosted HTTP mode, Bearer authentication is enforced by default using SLACK_MCP_HTTP_AUTH_TOKEN and access is restricted to allowed origins via SLACK_MCP_HTTP_ALLOWED_ORIGINS. The Quick Start demonstrates how to set up, diagnose, and inspect status, while the architecture mentions local session mirroring to use your existing Slack session credentials.

Prerequisites:

• Node.js 20+ (recommended)
• npm (bundled with Node.js)
• Access to an Slack workspace to authorize and configure tokens

Step-by-step:

1. Install Node.js 20+ from the official site or using your system package manager.
2. Install and run the MCP server via npx (recommended):

npx -y @jtalk22/slack-mcp --setup

3. Verify installation and status:

npx -y @jtalk22/slack-mcp@latest --version
npx -y @jtalk22/slack-mcp@latest --doctor
npx -y @jtalk22/slack-mcp@latest --status

4. If you plan to use hosted HTTP, set up tokens and host configuration according to the setup guide, including exporting SLACK_MCP_HTTP_AUTH_TOKEN and SLACK_MCP_HTTP_ALLOWED_ORIGINS as needed.

Optional (Docker):

• Pull the image for local hosting and run with your preferred runtime:

docker pull ghcr.io/jtalk22/slack-mcp-server:latest

Optional (Manual installation for development):

git clone https://github.com/jtalk22/slack-mcp-server.git
cd slack-mcp-server
npm install

Notes and tips:

• For hosted HTTP usage, ensure SLACK_MCP_HTTP_AUTH_TOKEN is set to an appropriate secret, and restrict origins via SLACK_MCP_HTTP_ALLOWED_ORIGINS to prevent unauthorized access.
• Tokens are stored securely at ~/.slack-mcp-tokens.json after setup; keep this file backed up.
• The Tools section lists all available MCP commands; try slack_list_conversations and slack_search_messages to explore workspace data before performing write operations with slack_send_message.
• If you encounter credential or connectivity issues, run --doctor and --status to get actionable guidance and ensure you are using the latest release with npx @jtalk22/slack-mcp@latest.
• Local-session mirroring relies on your browser session or token injection; ensure Slack is accessible in the current environment for token extraction on macOS (auto) or follow manual steps on other platforms.