| name | slack |
| description | Read Slack messages, threads, and channels via CLI. Use when asked to view Slack URLs, search Slack, or look up Slack users. |
| allowed-tools | Bash(slack-cli:*) |
Slack CLI
A CLI for reading Slack content - messages, threads, channels, and users.
Installation
If slack-cli is not on PATH, install it:
brew install lox/tap/slack-cli
Or: go install github.com/lox/slack-cli@latest
See https://github.com/lox/slack-cli for setup instructions (Slack app creation and OAuth).
Available Commands
slack-cli view <url> # View any Slack URL (message, thread, or channel)
slack-cli search <query> # Search messages
slack-cli channel list # List channels you're a member of
slack-cli channel read # Read recent messages from a channel
slack-cli channel info # Show channel information
slack-cli thread read # Read a thread by URL or channel+timestamp
slack-cli user list # List users in the workspace
slack-cli user info # Show user information
slack-cli auth config # Configure Slack app credentials
slack-cli auth login # Authenticate with Slack via OAuth
slack-cli auth status # Show authentication status
Common Patterns
View a Slack URL the user shared
slack-cli view "https://workspace.slack.com/archives/C123/p1234567890" --markdown
Search for messages
slack-cli search "from:@username keyword"
slack-cli search "in:#channel-name keyword"
Read a channel
slack-cli channel read
Discovering Options
To see available subcommands and flags, run --help on any command:
slack-cli --help
slack-cli view --help
slack-cli search --help
Notes
- Use
--markdown flag when you need to process or quote the output
- Thread URLs with
thread_ts parameter are automatically detected
- Channel names can include or omit the
# prefix
- User lookup accepts both user IDs (U123ABC) and email addresses
