claude-code-slack-channel

Two-way Slack ↔ Claude Code bridge. Chat with Claude from Slack DMs and channels, just like you'd chat in the terminal.

[](https://github.com/jeremylongshore/claude-code-slack-channel/actions/workflows/ci.yml) [](LICENSE)

> Research Preview — Channels require Claude Code v2.1.80+ and claude.ai login.

Slack workspace (cloud)
    ↕ WebSocket (Socket Mode — outbound only, no public URL)
server.ts (local MCP server, spawned by Claude Code)
    ↕ stdio (MCP transport)
Claude Code session

Socket Mode means no public URL needed — works behind firewalls, NAT, anywhere.

1. Go to api.slack.com/apps → Create New App → From scratch
2. Socket Mode: Settings → Socket Mode → Enable → Generate App-Level Token (xapp-...) with connections:write scope
3. Event Subscriptions: Enable → Subscribe to bot events:

• message.im — DMs
• message.channels — public channels
• message.groups — private channels
• app_mention — @ mentions

1. Bot Token Scopes (OAuth & Permissions):

• chat:write — send messages
• channels:history — read public channels
• groups:history — read private channels
• im:history — read DMs
• reactions:write — add reactions
• files:read — download shared files
• files:write — upload files
• users:read — resolve display names

1. Install to Workspace → Copy Bot Token (xoxb-...)

/slack-channel:configure xoxb-your-bot-token xapp-your-app-token

Pick your runtime:

cd slack && bun install
# Current (claude-code-plugins marketplace):
claude --channels plugin:slack-channel@claude-code-plugins
# Futu