| name | slack |
| description | Send messages, manage channels, reactions, and files in Slack with declarative channel-level permissions |
| allowed-tools | Bash(./scripts/*) |
Slack
Send messages, manage channels, reactions, and files in Slack. All operations respect declarative channel-level and feature-level permissions defined in the slack section of BAND.md.
IMPORTANT: You MUST use ONLY the scripts provided below for ALL Slack operations. Do NOT use curl, the Slack API directly, any Slack CLI, SDK, or any other tool. Every Slack interaction must go through ./scripts/<script-name>. If a script doesn't exist for what you need, say so — do not work around it.
Run scripts with ./scripts/<script-name>, e.g. ./scripts/channel-list --limit=5. Use --help on any script to see its parameters.
Permissions
Scripts enforce restrictions from the slack config section in BAND.md before making any API call. This provides application-level authorization on top of Slack API scopes:
- channels.allow — If set, ONLY these channels work. Empty means none allowed.
- channels.deny — Always blocked. Deny takes precedence over allow.
- dm — Direct messages (default: disabled).
- threads — Thread replies (default: disabled).
- reactions — Adding/removing reactions (default: disabled).
- files — File uploads (default: disabled).
- search — Message search (default: disabled).
Available scripts
Messages
message-send — Send a message to a channel. Input: channel, text, thread_tsmessage-list — List recent messages in a channel. Input: channel, limitmessage-search — Search messages. Requires SLACK_USER_TOKEN. Input: query, channel, limit
Channels
channel-list — List channels. Input: types, limitchannel-info — Get channel details. Input: channel
Threads
thread-reply — Reply to a thread. Input: channel, thread_ts, text
Reactions
reaction-add — Add a reaction to a message. Input: channel, timestamp, emojireaction-remove — Remove a reaction from a message. Input: channel, timestamp, emoji
Files
file-upload — Upload a file to a channel. Input: channel, filename, content, title
Notes
message-search requires a user token (xoxp-), not a bot token. Set SLACK_USER_TOKEN for search.- Channel references accept
#channel-name or Slack channel IDs (e.g., C01234ABCDE).
- Execution target is
local-lima — scripts run in an isolated Lima VM.
