Two-way Slack channel for Claude Code — chat from Slack DMs and channels via Socket Mode

2 Skills

5 MCP Tools

MIT License

$undefined undefined/undefined Pricing

Installation

Open Claude Code and run this command:

/plugin install slack-channel@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

Two-way Slack ↔ Claude Code bridge. Chat with Claude from Slack DMs and channels, just like you'd chat in the terminal. Per-thread session isolation, hash-chained tamper-evident audit journal with optional per-channel Slack projection, policy-gated tools, five-layer prompt-injection defense.

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

![License: MIT](LICENSE)

![OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/jeremylongshore/claude-code-slack-channel)

Links: Gist One-Pager · GitHub Pages · Release Notes

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

Skills (3)

access SKILL.md View full skill →

Manage Slack channel access control — pairing, allowlist, channel opt-in.

[ReadWriteEdit]

/slack-channel:access

Manage who can reach your Claude Code session through Slack.

Usage


/slack-channel:access pair <code>                          # Approve a pending pairing
/slack-channel:access policy <pairing|allowlist|disabled>   # Set DM policy
/slack-channel:access add <slack_user_id>                   # Add user to allowlist
/slack-channel:access remove <slack_user_id>                # Remove from allowlist
/slack-channel:access channel <channel_id> [--mention] [--allow <user_id,...>]  # Opt in a channel
/slack-channel:access channel remove <channel_id>           # Remove channel opt-in
/slack-channel:access status                                # Show current config

State File

~/.claude/channels/slack/access.json

Instructions

Parse $ARGUMENTS and execute the matching subcommand:

`pair`



Load access.json
Find the pending entry matching  (case-insensitive)

If not found or expired: show "No pending pairing with that code."
If found:


Add entry.senderId to allowFrom
Remove the pending entry
Save access.json with permissions 0o600
Show: Approved! User  can now DM this session.
Send a confirmation message to the user in Slack (via the reply tool if the MCP server is running)

policy 

Validate mode is one of: pairing, allowlist, disabled
Update dmPolicy in access.json
Save with 0o600
Show the new policy and what it means:


pairing: New DMs get a code to approve (default)
allowlist: Only pre-approved users can DM
disabled: No DMs accepted

add 

Add the Slack user ID to allowFrom (deduplicate)
Save with 0o600
Show confirmation

remove 

Remove from allowFrom
Also remove from any channel-level allowFrom lists
Save with 0o600
Show confirmation

channel  [--mention] [--allow ]

Parse options:


--mention: require @mention to trigger (default: false)
--allow : restrict to specific users in that channel


Add/update channels[channel_id] in access.json
Save with 0o600
Show the channel policy

channel remove 

Delete channels[channel_id]
Save with 0o600


                
                  
                  
                  configure
                  SKILL.md
                  View full skill →
                
                
                  Configure Slack channel tokens (bot token + app-level token).
                  
                      [ReadWriteBash(cmd:chmod)"]
                    
                
                
                  /slack-channel:configure
Configure the Slack channel with your bot token and app-level token.
Usage

/slack-channel:configure <xoxb-bot-token> <xapp-app-token>

Instructions

Parse the two arguments from $ARGUMENTS:


First token must start with xoxb- (Bot User OAuth Token)
Second token must start with xapp- (App-Level Token)


If either token is missing or has the wrong prefix, show this error and stop:


   Error: Two tokens required.
     - Bot token (starts with xoxb-) from OAuth & Permissions
     - App token (starts with xapp-) from Socket Mode settings

   Usage: /slack-channel:configure xoxb-... xapp-...


Create the state directory if it doesn't exist:


   ~/.claude/channels/slack/


Write the .env file at ~/.claude/channels/slack/.env:


   SLACK_BOT_TOKEN=<bot-token>
   SLACK_APP_TOKEN=<app-token>


Set file permissions to owner-only:


   chmod 600 ~/.claude/channels/slack/.env


Confirm success:


   Slack channel configured.

   Start Claude with the Slack channel:
     claude --channels plugin:slack-channel@claude-code-plugins

   Or for development:
     claude --dangerously-load-development-channels server:slack

Security

Never echo the tokens back in the confirmation message
Never log tokens to stdout or any file other than .env
Always set 0o600 permissions on the .env file


                
                  
                  
                  policy
                  SKILL.md
                  View full skill →
                
                
                  Author MCP tool-call policy rules without hand-editing access.
                  
                      [ReadWriteEditBash(cmd:bun)Bash(cmd:chmod)"]
                    
                
                
                  /slack-channel:policy
Author, lint, and remove policy rules under access.json's top-level policy field.
The evaluator (evaluate() in policy.ts) is the veto layer for every MCP tool
call — this skill is the ergonomic front door to authoring rules without opening
access.json in a text editor.
See ACCESS.md §Policy schema for the full
rule shape and semantics. This skill does not replace the hand-edit path; it
complements it.
Usage

/slack-channel:policy list
/slack-channel:policy lint
/slack-channel:policy add <id> <effect> <json-match> [--reason "..."] [--ttl-ms N] [--approvers N] [--priority N]
/slack-channel:policy remove <id>

Effect is one of autoapprove, deny, requireapproval.
json-match is a JSON object literal for the match field — e.g.
'{"tool":"read_file","pathPrefix":"/workspace/docs"}'. At least one field
must be populated; the validator rejects empty matches.
Options by effect

Effect
Required
Optional


auto_approve
—
--priority


deny
--reason "…" (1-200)
--priority


require_approval
—
--ttl-ms, --approvers, --priority


Defaults: priority=100, ttl-ms=300000 (5 min), approvers=1.
State file
~/.claude/channels/slack/access.json — the policy field is a JSON array.
A missing or empty array means "no authored rules" and is valid.
Instructions
Parse $ARGUMENTS and execute the matching subcommand. Before every write, run
the validator script. Exit cleanly without writing if validation fails.
list

Read ~/.claude/channels/slack/access.json
If the policy field is missing or empty, print No policy rules authored. Evaluator applies defaults — see ACCESS.md §Default-branch behavior. and return.
Otherwise, print a table: id | effect | match summary | extras.


match summary — join populated fields: tool=read_file pathPrefix=/workspace (omit undefined fields).
extras — for deny show reason=…; for require_approval show ttlMs=… approvers=….

lint

Run: bun script



      
      
          How It Works
          1. Create a Slack App

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


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


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


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

2. Configure Tokens

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

3. Run
Pick your runtime:
Option A: Bun (recommended)

bun install
claude --channels plugin:slack-channel@claude-code-plugins

Option B: Node.js / npx

npm install
claude --channels plugin:slack-channel@claude-code-plugins

Option C: Docker

docker build -t claude-slack-channel .
claude --channels plugin:slack-channel@claude-code-plugins

4. Pair Your Account

DM the bot in Slack — you'll get a 6-character pairing code
In your terminal: /slack-channel:access pair 

You're connected. Chat away.

        


      
      

      
      

      
      
  Ready to use slack-channel?
  
    
    
        
        View on GitHub
      
  




      
      
          Related Plugins
          
            
                ai-experiment-logger
                Track and analyze AI experiments with a web dashboard and MCP tools
              
                conversational-api-debugger
                Debug REST API failures using OpenAPI specs and HTTP logs (HAR) - root cause analysis with cURL generation
              
                design-to-code
                Convert Figma designs and screenshots to React/Svelte/Vue components with built-in accessibility
              
                domain-memory-agent
                Knowledge base with TF-IDF semantic search and extractive summarization - no ML dependencies required
              
                lumera-agent-memory
                Durable agent memory with Cascade object storage, client-side encryption, and local full-text search index. Persists agent context across sessions.
              
                project-health-auditor
                Multi-dimensional code health analysis with complexity, churn, and test coverage - identifies technical debt hot spots
              
          
        

      
      
          Tags
          
            slackchannelmcpsocket-modechatopsclaude-code

Effect	Required	Optional
`auto_approve`	—	`--priority`
`deny`	`--reason "…"` (1-200)	`--priority`
`require_approval`	—	`--ttl-ms`, `--approvers`, `--priority`

slack-channel

Installation

What It Does

Skills (3)

/slack-channel:access

Usage

State File

Instructions

`pair`

`policy`

`add`

`remove`

`channel [--mention] [--allow ]`

`channel remove`

/slack-channel:configure

Usage

Instructions

Security

/slack-channel:policy

Usage

Options by effect

State file

Instructions

`list`

`lint`

How It Works

1. Create a Slack App

2. Configure Tokens

3. Run

Option A: Bun (recommended)

Option B: Node.js / npx

Option C: Docker

4. Pair Your Account

Ready to use slack-channel?

Related Plugins