Slack命令行工具与MCP服务器

slackcli

A Slack CLI and MCP server built for AI agents.

JSON-first output, structured errors, and automatic pagination,
with a read-only mode that keeps agents from posting or deleting.

Installation · Quick Start · Commands · MCP Server · Read-Only Mode

Most Slack tools are built for people at a keyboard. An agent needs something else: output it can parse, errors it can branch on, pagination it doesn't have to manage, and a guarantee that it can't post to #general by accident. slackcli gives you that as a single binary. Run it from scripts, or plug it into any MCP client as a stdio server.

Features

• CLI and MCP in one binary: channels, messages, users, files, reactions and search, from the shell or as MCP tools
• JSON-first output: JSON when piped, a table in a terminal, or forced with -o json|table
• Read-only mode: --read-only rejects write commands in the CLI and hides write tools from MCP clients
• Automatic pagination: cursor-based paging on list commands, plus --all to fetch every page
• Rate-limit retries: rate-limited calls are retried up to 3 times, honoring Slack's Retry-After; a call still limited after that fails with rate_limited
• Structured errors: Slack errors are classified (auth_error, not_found, rate_limited, permission_denied, ...) and mapped to exit codes
• Multiple workspaces: store several tokens, switch between them with auth switch, or pick one per command with -w

Installation

Homebrew

brew install jackchuka/tap/slackcli

Go

go install github.com/jackchuka/slackcli/cmd/slackcli@latest

Binary

Download a prebuilt binary for Linux, macOS, or Windows from the releases page.

From Source

git clone https://github.com/jackchuka/slackcli.git
cd slackcli
make build   # writes bin/slackcli

Quick Start

1. Create a Slack app at api.slack.com/apps, add the scopes you need (for example channels:read, chat:write, search:read), and install it to your workspace.

2. Copy the token (xoxb-... or xoxp-...) from OAuth & Permissions, and either export it or save it:

   复制

   export SLACK_TOKEN=xoxb-your-token
   # or store it in the config file
   slackcli auth login --token xoxb-your-token
   

3. Run a command:

   复制

   slackcli channels list
   slackcli messages search --query "deploy" --limit 5
   

Authentication

The token is resolved in this order:

1. --token flag
2. -w, --workspace flag: a workspace saved with auth login
3. SLACK_TOKEN environment variable
4. The active workspace in the config file

auth login verifies the token with Slack, then saves it under a workspace name (the team name by default, or --name). The config file lives at slackcli/config.json in your OS config directory: ~/.config on Linux, ~/Library/Application Support on macOS.

slackcli auth login --token xoxb-your-token --name team-a
slackcli auth list            # configured workspaces
slackcli auth switch team-a   # change the active workspace
slackcli auth status          # check the current token against Slack
slackcli auth logout [name]   # remove a workspace (default: the active one)

-w selects a saved workspace for a single command without changing the active one. auth status and auth logout act on it too:

slackcli -w team-b channels list
slackcli -w team-b auth status

An unknown workspace name is an error.

Commands

Arguments in <angle brackets> are positional. Flags marked * are required.

Channels

Messages

Users

Files

Reactions

Other

Global flags

Examples

slackcli channels list --all -o json | jq -r '.items[].name'
slackcli messages send --channel C0123456789 --text "Build finished"
slackcli messages reply --channel C0123456789 --thread-ts 1700000000.000100 --text "Done"
slackcli files upload --channel C0123456789 --file ./report.pdf --title "Weekly report"
slackcli reactions add --channel C0123456789 --timestamp 1700000000.000100 --name thumbsup

MCP Server

slackcli mcp serve speaks MCP over stdio. Add it to your MCP client's config:

{
  "mcpServers": {
    "slack": {
      "command": "slackcli",
      "args": ["mcp", "serve"],
      "env": {
        "SLACK_TOKEN": "xoxb-your-token"
      }
    }
  }
}

If SLACK_TOKEN is not set, the server uses the active workspace from slackcli auth login. To serve a different saved workspace, use "args": ["-w", "team-b", "mcp", "serve"]. The server reports slackcli's version to the client.

Read-Only Mode

Add --read-only when an agent should be able to look but not touch.

In the CLI, write commands fail before any API call:

$ slackcli --read-only messages send --channel C0123456789 --text "hello"
Error: command "slackcli messages send" is a write operation and cannot be used in read-only mode

In the MCP server, write tools aren't registered at all, so the agent never sees them. Only the 11 read tools from the table above are exposed:

{
  "mcpServers": {
    "slack-readonly": {
      "command": "slackcli",
      "args": ["--read-only", "mcp", "serve"],
      "env": {
        "SLACK_TOKEN": "xoxb-your-token"
      }
    }
  }
}

Output and Exit Codes

List commands return {"items": [...], "next_cursor": "...", "has_more": true}. Pass next_cursor back with --cursor, or use --all to fetch every page. In table mode, the next cursor is printed below the table.

License

MIT