/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

1. 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)

2. 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-...
   

3. Create the state directory if it doesn't exist:

   ~/.claude/channels/slack/
   

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

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

5. Set file permissions to owner-only:

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

6. 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

On validation failure, displays the error with correct usage syntax.

Error Handling

Error	Cause	Resolution
Missing token argument	Fewer than 2 arguments provided	Show usage with required token prefixes
Invalid bot token prefix	First token does not start with xoxb-	Explain where to find the Bot User OAuth Token
Invalid app token prefix	Second token does not start with xapp-	Explain where to find the App-Level Token in Socket Mode settings
Permission denied	Cannot write to ~/.claude/channels/slack/	Check directory permissions and create parent dirs if needed

Examples

Standard configuration:

/slack-channel:configure xoxb-1234567890-abcdef xapp-1-ABCDEF-ghijkl
→ Slack channel configured.

Missing token error:

/slack-channel:configure xoxb-1234567890
→ Error: Two tokens required.
  - Bot token (starts with xoxb-) from OAuth & Permissions
  - App token (starts with xapp-) from Socket Mode settings

Resources

• Slack API: Creating an app — app setup walkthrough
• Slack Socket Mode — how to enable and get app-level tokens
• Access control: /slack-channel:access — configure who can message your session