Skip to content
skillsaggregatorskillsaggregator
Privacy: This guide links directly to Slack's credential pages. We never ask you to enter, store, or transmit any credential through this site. Zero outbound calls to anything but the vendor's docs.

Slack MCP — Auth Setup

Slack uses bot tokens and a team (workspace) ID to authenticate API requests on behalf of your app.

1. Get your credentials

  1. Open the Slack API Apps page (opens Slack — we never see your token)
  2. Select your app (or create a new one), then go to OAuth & Permissions
  3. Copy the Bot User OAuth Token under "OAuth Tokens for Your Workspace"
  4. Your Team ID (workspace ID) can be found in Settings > Basic Information or in the workspace URL: app.slack.com/client/<team_id>

2. Set environment variables

macOS / Linux — add to ~/.zshrc or ~/.bashrc:

export SLACK_BOT_TOKEN=YOUR_BOT_TOKEN_HERE
export SLACK_TEAM_ID=YOUR_TEAM_ID_HERE

Then run source ~/.zshrc (or open a new terminal).

Windows — run in Command Prompt (then restart):

setx SLACK_BOT_TOKEN "YOUR_BOT_TOKEN_HERE"
setx SLACK_TEAM_ID "YOUR_TEAM_ID_HERE"

3. Verify

npx claude-skills doctor

You should see ✅ next to the Slack MCP entry. If you see ❌, confirm the token is set: echo $SLACK_BOT_TOKEN.

4. Restart Claude Code

Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the Slack MCP appears).