A Bun CLI + Claude Code plugin that replaces the 12 Slack MCP server tools with a single, token-efficient CLI. Instead of spending ~18K tokens per session on MCP tool descriptions, Claude loads a lightweight skill file and calls agent-slack via Bash.
- Bun v1.0+
- A Slack workspace you can authorize against
agent-slack loginThis opens your browser for Slack OAuth authorization. Click "Allow" and the token is saved to ~/.agent-slack/config.json.
agent-slack read-user-profile # verify it works
agent-slack logout # remove stored tokenbrew tap asafrose/agent-slack
brew install agent-slackgit clone https://github.com/Asafrose/agent-slack.git
cd agent-slack
bun install
bun linkagent-slack <command> [flags]
agent-slack --help
agent-slack <command> --help| Command | Description | Replaces MCP Tool |
|---|---|---|
send-message |
Send a message to a channel | slack_send_message |
schedule-message |
Schedule a message for later | slack_schedule_message |
draft-message |
Create a draft message | slack_send_message_draft |
search-channels |
Find channels by name/purpose | slack_search_channels |
read-channel |
Read channel message history | slack_read_channel |
search-messages |
Search public channel messages | slack_search_public |
read-thread |
Read a thread's messages | slack_read_thread |
search-users |
Find users by name/email/title | slack_search_users |
read-user-profile |
Get a user's profile | slack_read_user_profile |
search-all |
Search all channels incl. private/DMs | slack_search_public_and_private |
create-canvas |
Create a Canvas document | slack_create_canvas |
read-canvas |
Read a Canvas document | slack_read_canvas |
login |
Authenticate with Slack via OAuth | — |
logout |
Remove stored Slack token | — |
Every command supports three output modes:
agent-slack read-channel --channel C12345 # concise (default, token-efficient)
agent-slack read-channel --channel C12345 --detailed # verbose with all fields
agent-slack read-channel --channel C12345 --json # raw JSON, pipe to jqCommands that accept text (send-message, schedule-message, draft-message, create-canvas) support three input methods:
# Inline
agent-slack send-message --channel C12345 --text "Hello world"
# From file (recommended for complex content)
agent-slack send-message --channel C12345 --text-file /tmp/message.md
# From stdin
echo "Hello world" | agent-slack send-message --channel C12345For create-canvas, use --content / --content-file instead of --text / --text-file.
# Send a message
agent-slack send-message --channel C12345 --text "Deploy complete"
# Search for a channel, get its ID
agent-slack search-channels --query "engineering" --json | jq -r '.channels[0].id'
# Read last 20 messages from a channel
agent-slack read-channel --channel C12345 --limit 20
# Search messages with Slack search syntax
agent-slack search-messages --query "from:<@U12345> in:engineering bug after:2024-01-01"
# Read a thread
agent-slack read-thread --channel C12345 --ts 1234567890.123456
# Schedule a message
agent-slack schedule-message --channel C12345 --text "Reminder" --post-at "2025-03-01T09:00:00Z"
# Look up a user
agent-slack read-user-profile --user U12345This project is a Claude Code plugin. It includes a skill (skills/slack/SKILL.md) that teaches Claude how to use the CLI for all Slack operations.
Install the plugin from within Claude Code using the /plugin command:
-
Add the marketplace (one-time):
/plugin marketplace add Asafrose/agent-slack -
Install the plugin:
/plugin install agent-slack@agent-slack
You can choose to install at user scope (default, applies to all projects) or project scope (applies to the current repository only).
For local development or testing, you can also load the plugin directly from a local directory:
claude --plugin-dir /path/to/agent-slackOnce loaded, Claude will automatically use agent-slack via Bash whenever Slack tasks arise — no MCP server needed.
- The skill file (
skills/slack/SKILL.md) contains complete documentation of all 12 commands, flags, search syntax, output formats, and error codes - It declares
allowed-tools: Bash(agent-slack *)so Claude can run the CLI without per-command approval - It's marked
user-invocable: false— Claude auto-activates it when Slack tasks are detected - The plugin manifest (
.claude-plugin/plugin.json) registers the plugin with Claude Code
The 12 MCP Slack tools consume ~18K tokens per session from their tool descriptions alone. This plugin replaces all of them with a single skill file that Claude loads on demand, dramatically reducing per-session token overhead.
bun test # all tests (unit + integration)
bun test tests/unit # unit tests only
bun test tests/integration # integration tests onlyagent-slack/
├── .claude-plugin/plugin.json # Claude Code plugin manifest
├── skills/slack/SKILL.md # Skill: teaches Claude to use the CLI
├── bin/agent-slack.ts # CLI entry point
├── src/
│ ├── cli.ts # Commander program, registers subcommands
│ ├── client.ts # Slack WebClient factory (auth via config)
│ ├── config.ts # Loads/saves ~/.agent-slack/config.json
│ ├── constants.ts # OAuth config (client ID, worker URL, scopes)
│ ├── output.ts # Concise / detailed / JSON formatters
│ ├── errors.ts # Slack API error handling
│ ├── input.ts # Text input resolution (inline/file/stdin)
│ ├── formatters/messages.ts # Shared message formatting
│ └── commands/ # 14 subcommand implementations (incl. login/logout)
├── worker/ # Cloudflare Worker (OAuth token exchange proxy)
│ ├── src/index.ts # Worker entry point
│ ├── wrangler.toml # Worker config
│ └── package.json
├── tests/
│ ├── unit/ # Mocked unit tests per module
│ ├── integration/cli.test.ts # End-to-end CLI invocation tests
│ └── helpers/mock-slack.ts # Shared Slack API mock factory
├── package.json
└── tsconfig.json
MIT