Slackcli

🚀 slackcli

AIにより、AIのために作られたSlack CLIとMCPサーバーです。LLMパワードのエージェントとプログラムによるアクセスに最適化されています。

🚀 クイックスタート

1. Slackアプリを作成 し、必要なスコープ（例：channels:read, chat:write, search:read）でワークスペースにインストールします。
2. OAuth & Permissions からBotまたはユーザーのOAuthトークン (xoxb-...) を取得します。
3. 以下のコマンドを実行します。

brew install jackchuka/tap/slackcli
export SLACK_TOKEN=xoxb-your-token
slackcli channels list

✨ 主な機能

• チャンネル、メッセージ、ユーザー、ファイル、リアクション、検索に関する CLIコマンド
• AIエージェントとの統合のための MCPサーバー (stdioトランスポート)
• LLMの消費に最適化された JSON優先の出力 で、TTY対応のテーブルフォールバック付き
• 自動リトライによる レート制限の処理
• 構造化されたエラーコードによる エラー分類
• すべてのリスト操作での ページネーションサポート
• AIエージェントによる誤った書き込みを防止する 読み取り専用モード

📦 インストール

Homebrewを使用する場合

brew install jackchuka/tap/slackcli

Goを使用する場合

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

ソースからビルドする場合

make build

🔐 認証

Slackトークンは環境変数またはCLIで設定できます。

# 環境変数を使用する場合
export SLACK_TOKEN=xoxb-your-token

# またはauthコマンドを使用する場合
slackcli auth login --token xoxb-your-token

# 名前付きワークスペースを使用する場合
slackcli auth login --token xoxb-your-token --name my-workspace

トークンの解決順序は、--token フラグ > SLACK_TOKEN 環境変数 > 保存された設定です。

💻 使用例

CLI

# チャンネル
slackcli channels list
slackcli channels info C1234567890
slackcli channels create new-channel

# メッセージ
slackcli messages list --channel C1234567890
slackcli messages send --channel C1234567890 --text "Hello"
slackcli messages search --query "important"

# ユーザー
slackcli users list
slackcli users info U1234567890

# ファイル
slackcli files list
slackcli files upload --channel C1234567890 --file ./report.pdf

# リアクション
slackcli reactions add --channel C1234567890 --timestamp 1234567890.123456 --name thumbsup
slackcli reactions list --user U1234567890

MCPサーバー

AIエージェントとの統合のためにMCPサーバーを起動します。

slackcli mcp serve

MCPクライアント（例：Claude Desktop）で設定します。

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

利用可能なMCPツール:

読み取り専用モード

--read-only を使用すると、読み取り専用操作に制限されます。これにより、AIエージェントが誤ってメッセージを送信したり、ファイルを削除したり、チャンネルを変更したりすることを防ぎます。

CLI -- 書き込みコマンドは実行前に拒否されます。

slackcli --read-only channels list           # 正常に動作します
slackcli --read-only messages send ...       # ブロックされます
# エラー: コマンド "slackcli messages send" は書き込み操作であり、読み取り専用モードでは使用できません

MCPサーバー -- 書き込みツールは完全に非表示になります（AIエージェントは見ることができません）。

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

読み取り専用ツール（常に利用可能）: auth_test, list_channels, get_channel_info, list_messages, list_users, get_user_info, get_user_presence, list_reactions, list_files, get_file_info, search_messages。

書き込みツール（読み取り専用モードでは非表示）: create_channel, archive_channel, invite_to_channel, kick_from_channel, set_channel_topic, set_channel_purpose, send_message, edit_message, delete_message, add_reaction, remove_reaction, delete_file。

出力形式

# JSON出力を強制する場合
slackcli channels list -o json

# テーブル出力を強制する場合
slackcli channels list -o table

デフォルト: TTYの場合はテーブル、パイプ出力の場合はJSON。

📄 ライセンス

MIT