Slack MCP Server

Give Claude your Slack. 16 self-hosted tools for channels, search, replies, reactions, unread triage, and user search. Self-host free or use Slack MCP Cloud for Claude-first managed transport, Gemini CLI support, hosted credential handling, deployment review, and procurement-ready security review.

Verify & Proof

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

20-second demo · Interactive demo · Start here discussion · Latest release notes · Release-day runbook · Commercial surface map · Distribution ledger · Release health snapshot · Version parity report · Cloud pricing · Workflows · Gemini CLI · Readiness · Cloud deployment · Cloud security · Cloud support

Tools

| Tool | Description | Safety | |------|-------------|--------| | slack_health_check | Verify token validity and workspace info | read-only | | slack_token_status | Token age, health, and cache stats | read-only | | slack_refresh_tokens | Auto-extract fresh tokens from Chrome | read-only* | | slack_list_conversations | List DMs and channels | read-only | | slack_conversations_history | Get messages from a channel or DM | read-only | | slack_get_full_conversation | Export full history with threads | read-only | | slack_search_messages | Search across workspace | read-only | | slack_get_thread | Get thread replies | read-only | | slack_users_info | Get user details | read-only | | slack_list_users | List workspace users (paginated, 500+) | read-only | | slack_users_search | Search users by name, display name, or email | read-only | | slack_conversations_unreads | Get channels/DMs with unread messages | read-only | | slack_send_message | Send a message to any conversation | destructive | | slack_add_reaction | Add an emoji reaction to a message | destructive | | slack_remove_reaction | Remove an emoji reaction from a message | destructive | | slack_conversations_mark | Mark a conversation as read | destructive |

All tools carry MCP safety annotations: 12 read-only (readOnlyHint: true), 4 write-path (destructiveHint: true). Only slack_send_message is non-idempotent.

* slack_refresh_tokens modifies local token file only — no external Slack state.

Cloud

Slack MCP Cloud provides 15 managed tools with hosted credential handling. Team adds 3 AI compound workflows for summaries, action items, and decisions. Claude is the primary path; Gemini CLI is the second supported client path on the hosted endpoint.

• Self-host if you want 16 tools, npm or Docker, and full operator control over runtime and tokens.
• Use Cloud if you want one remote endpoint, hosted credential handling, deployment review, buyer-facing security review, support, and a hosted account surface.
• Solo starts at $19/mo; Team is $49/mo and adds 3 AI workflows plus higher request capacity.
• Turnkey Team Launch starts at $2.5k+; Managed Reliability starts at $800/mo+ for teams where rollout and operational continuity matter more than raw seat count.

| Plan | Price | Includes | |------|-------|----------| | Solo | $19/mo | 15 standard tools, AES-256-GCM encrypted storage, 5K requests/mo | | Team | $49/mo | 15 standard + 3 AI compound tools, 3 workspaces, 25K requests/mo | | Turnkey Team Launch | $2.5k+ | Deployment review, rollout sequencing, client setup guidance, first-production-use path | | Managed Reliability | $800/mo+ | Ongoing operating review, token-health follow-up, workflow continuity support |

Pricing · Workflows · Gemini CLI · Readiness · Cloud Docs · Security & Procurement · Procurement Brief · Account · Deployment Review · Cloud Support · Privacy Policy

For rollout help or managed deployment review, use Cloud deployment review. For buyer-facing controls, storage, analytics, and procurement questions, use Cloud security and the procurement brief. Reproducible self-host bugs stay in standard issues; hosted operational questions belong on Cloud support.

Operated by Revasser. Self-host support is best-effort; managed rollout and Cloud support stay on mcp.revasserlabs.com.

Install & Verify (Self-Hosted)

Runtime: Node.js 20+

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

The setup wizard handles token extraction and validation automatically.

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"]
    }
  }
}

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"],
      "env": {
        "SLACK_TOKEN": "xoxc-your-token",
        "SLACK_COOKIE": "xoxd-your-cookie"
      }
    }
  }
}

Windows/Linux users must provide tokens via env since auto-refresh is macOS-only.

Add to ~/.claude.json:

{
  "mcpServers": {
    "slack": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"]
    }
  }
}

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

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-v", "~/.slack-mcp-tokens.json:/root/.slack-mcp-tokens.json",
               "ghcr.io/jtalk22/slack-mcp-server"]
    }
  }
}

Restart Claude after configuration. Full setup guide: docs/SETUP.md

Hosted HTTP Mode

For remote MCP endpoints (Cloudflare Worker, VPS, etc.):

SLACK_TOKEN=xoxc-... \
SLACK_COOKIE=xoxd-... \
SLACK_MCP_HTTP_AUTH_TOKEN=change-this \
SLACK_MCP_HTTP_ALLOWED_ORIGINS=https://claude.ai \
node src/server-http.js

Details: docs/DEPLOYMENT-MODES.md

Troubleshooting

Tokens expired: Run npx -y @jtalk22/slack-mcp --setup or use slack_refresh_tokens in Claude (macOS).

DMs not showing: Use slack_list_conversations with discover_dms=true to force discovery.

Claude not seeing tools: Verify JSON syntax in config, check logs at ~/Library/Logs/Claude/mcp*.log, fully restart Claude (Cmd+Q).

More: docs/TROUBLESHOOTING.md

Docs

• Setup Guide — Token extraction and configuration
• API Reference — All 16 tools with parameters and examples
• Deployment Modes — stdio, web, hosted HTTP, Cloudflare Worker
• Use Case Recipes — 12 copy-paste prompts
• Troubleshooting — Common issues and fixes
• Compatibility — Client compatibility matrix
• Support Boundaries — Scope and response targets
• Docs Index — Full documentation index

Security

• Token files stored with chmod 600 (owner-only)
• macOS Keychain provides encrypted backup
• Web server binds to localhost only
• API keys are cryptographically random (crypto.randomBytes)
• See SECURITY.md for vulnerability reporting

Contributing

PRs welcome. Run node --check on modified files before submitting.

License

MIT — See LICENSE

Disclaimer

This project accesses Slack's Web API using browser session credentials. It is not affiliated with or endorsed by Slack Technologies, Inc. Slack workspace administrators should review their acceptable use policies.