| name | configure |
| description | Configure Slack channel tokens (bot token + app-level token) |
| version | 1.0.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | MIT |
| user-invocable | true |
| argument-hint | <bot-token> <app-token> |
| allowed-tools | Read, Write, Bash(chmod:*) |
| compatible-with | claude-code |
| tags | ["mcp","configure"] |
/slack-channel:configure
Overview
Configure the Slack channel MCP plugin by providing your Slack bot token and app-level token. Writes credentials to a secure .env file with owner-only permissions.
Prerequisites
- A Slack app created at api.slack.com/apps with Socket Mode enabled
- A Bot User OAuth Token (
xoxb-...) from OAuth & Permissions
- An App-Level Token (
xapp-...) from Socket Mode settings
- Write access to
~/.claude/channels/slack/
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
Output
On success, displays:
Slack channel configured.
Start Claude with the Slack channel:
claude --channels plugin:slack-channel@claude-code-plugins