公開日: 最終更新:
公式ドキュメント・公式発表などの一次情報を確認したうえで、株式会社Nexaが執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。運営会社について
gogcliとは、Gmail・Calendar・Driveなど27のGoogleサービスをターミナルから操作できるGo製CLIで、gwsとは設計が異なります。
- 要点1: gogcliは人が読めるラッパー構文（例:
gog gmail search "is:unread"）。27サービス対応、brew install openclaw/tap/gogcliで導入、OAuth 2.0で認証。最新版はv0.40.0（2026年9月11日） - 要点2: gwsはGoogle（googleworkspace）公開のRust製CLI。Discovery Serviceからコマンドを動的生成し、25サービスを標準列挙、100以上のAgent Skills付属。最新版はv0.22.5（2026年3月31日）で、READMEに「正式サポート製品ではない」「v1.0まで破壊的変更あり」と明記
- 要点3: 日常業務の自動化・チーム保守にはgogcli、Admin APIやAgent Skills前提のエージェント構成にはgws。両者は共存でき、gogcliから始める段階導入が現実的
対象: Claude CodeからGmail・Calendar・Driveを自動操作したい開発者・DX推進担当者
今日やること: brew install openclaw/tap/gogcli→gog auth add 自分のメールアドレス --services gmail,calendar,driveで認証→gog gmail search "is:unread"を1回実行して動作を確かめる
gogcliとは、Gmail・Calendar・Driveなど27のGoogleサービスをターミナル1つで操作できるGo製オープンソースCLIです。2026年9月14日時点の最新版はv0.40.0で、brew install openclaw/tap/gogcliで導入し、OAuth 2.0で認証すればClaude Codeからそのまま呼び出せます。一方、Google（googleworkspace）が公開するgwsはRust製で、GoogleのDiscovery Serviceからコマンドを動的生成する設計です。
この記事では、両ツールを実際にセットアップして使用した経験をもとに、コマンド構文・対応サービス・認証方法・Claude Code連携での違いを整理し、どちらを選ぶべきかの判断基準を具体的に示します。バージョンや対応サービス数は2026年9月14日に公式リポジトリで再確認した最新情報に更新しています。
gogcliとgwsの基本的な違い
結論から言えば、2つのツールは「設計思想が根本的に異なる」ために生まれた選択肢です。一言で言うと、gogcliは「人間が使いやすい高品質なラッパーCLI」、gwsは「Google APIを直接呼び出す動的なCLI」という位置づけです。
gogcliとは
gogcliは、Peter Steinberger氏（@steipete）が開発を始め、現在はOpenClawプロジェクト（github.com/openclaw/gogcli）で保守されているGo言語製のオープンソースCLIツールです。Gmail・Calendar・Drive・Sheets・Contacts・Tasksなど27のGoogleサービスをシンプルなコマンドで操作でき、2026年9月14日時点の最新版はv0.40.0（9月11日リリース）です。
コマンド構文は人間が読みやすい「ラッパー形式」で設計されています。
# Gmail検索
gog gmail search "from:example.com is:unread"
# 今日の予定取得
gog calendar list --today
# Driveにファイルをアップロード
gog drive upload ./report.pdf --folder "月次レポート"CLI操作に慣れていない方でも、コマンドを見ただけで何をしているかが直感的に理解できます。インストールはbrew install openclaw/tap/gogcli（Homebrew）またはgo installで行い、認証はOAuth 2.0のデスクトップクライアントを使います。トークンはOSのキーリング（ヘッドレス環境では暗号化ファイル）に保存され、複数アカウントの使い分けも可能です。
gwsとは
gwsは、GoogleのGoogle Workspace開発者向けGitHub組織（googleworkspace）が2026年3月に公開したRust製のCLIツールです（Apache-2.0ライセンス。2026年9月14日時点の最新版はv0.22.5・3月31日リリース）。READMEには「正式にサポートされたGoogle製品ではない」と明記されている点は押さえておきましょう。インストールはnpm install -g @googleworkspace/cliまたはbrew install googleworkspace-cli、認証はgws auth setupで行います。最大の特徴は「Google Discovery APIを使ってコマンドを動的に生成する」仕組みにあります。
# Gmail メッセージ一覧取得（gws構文）
gws gmail users messages list --userId me
# Driveファイル一覧
gws drive files list --q "name contains 'report'"
# Calendarイベント一覧
gws calendar events list --calendarId primaryコマンド構文はGoogle APIのリソース構造をそのまま反映しているため、APIドキュメントを読んだことがある方には親しみやすい形式です。一方で、APIを知らないと構文が読みづらく感じることもあります。
gwsには、Claude CodeをはじめとするAIエージェントがWorkspaceを操作するための100以上のAgent Skills（SKILL.mdファイル）が付属し、全レスポンスが構造化JSONで返る設計です。なお、初期バージョンにあったgws mcp（MCPサーバー）コマンドはv0.8.0で削除されています。2026年9月時点でもv1.0未達で、READMEに「v1.0に向けて破壊的変更がありうる」と明記されています。
コマンド構文と操作感の違い
同じ操作を実現するコマンドを比較すると、両ツールの思想の違いが明確になります。
主要操作のコマンド比較
| 操作 | gogcli | gws |
|---|---|---|
| 未読メール確認 | gog gmail search "is:unread" |
gws gmail users messages list --userId me --q "is:unread" |
| メール送信 | gog gmail send --to "xxx@gmail.com" --subject "件名" --body "本文" |
gws gmail users messages send --userId me + JSONペイロード |
| 今日の予定 | gog calendar list --today |
gws calendar events list --calendarId primary --timeMin "今日のISO8601" |
| ファイルアップロード | gog drive upload ./file.pdf |
gws drive files create + multipartリクエスト |
| タスク追加 | gog tasks add "タスク名" |
gws tasks tasklists tasks insert --tasklist @default + JSONペイロード |
gogcliは人間が直感的に使いやすい設計。gwsはAPIに忠実な設計でスクリプト・AI連携向きです。
出力形式の違い
gogcliの出力:
$ gog calendar list --today
9:00 チーム朝会（Google Meet）
14:00 クライアントMTG（社外）
16:00 週次振り返り（Zoom）gogcliはデフォルトで人間が読みやすいテキスト形式で出力します。--jsonオプションを追加すると機械処理向けのJSON出力に切り替わります。
gwsの出力:
{ "kind": "calendar#events", "items": [ { "summary": "チーム朝会", "start": { "dateTime": "2026-03-27T09:00:00+09:00" }, ... } ]}gwsはデフォルトでJSON出力。AIエージェントやシェルスクリプトでの後処理が前提の設計です。
＼ AI導入の進め方を一緒に整理しませんか ／
AI顧問の無料相談はこちら対応サービス・機能の比較
対応サービス一覧
| サービス | gogcli | gws |
|---|---|---|
| Gmail | ✅ 検索・送信・ラベル | ✅ 全API |
| Calendar | ✅ 取得・作成・招待 | ✅ 全API |
| Drive | ✅ アップロード・ダウンロード・共有 | ✅ 全API |
| Sheets | ✅ 読み取り・書き込み | ✅ 全API |
| Docs | ✅ 作成・テキスト追加 | ✅ 全API |
| Slides | ⚠️ 執筆当時は限定的（最新版は作成・編集に対応） | ✅ 全API |
| Tasks | ✅ 追加・完了・一覧 | ✅ 全API |
| Contacts / People | ✅ 検索・作成 | ✅ 全API |
| Chat | ✅ メッセージ送信 | ✅ 全API |
| Admin（管理コンソール） | ⚠️ 限定的 | ✅ 全API |
| Forms | ✅ 基本操作 | ✅ 全API |
| Apps Script（GAS） | ✅ clasp連携 | ✅ 全API |
| Groups | ✅ 対応 | ✅ 全API |
注意点：gogcliのSlides対応は限定的
執筆当時（2026年3月）に実際にgogcliでGoogleスライドの編集（画像差し替え・スライド内容の変更）を試みると、対応していたのは「エクスポート・コピー・メタデータ取得・新規作成」のみです。スライドの内容を直接編集したい場合は、gwsのGoogle Slides APIを直接呼び出すか、pptxでエクスポートしてローカルで編集→再アップロードという代替手順が必要です。
なお、2026年9月時点の公式READMEではSlidesの対応範囲が「Create/edit presentations（プレゼンテーションの作成・編集）」と記載され、直近のv0.40.0でもスライドの書式保持に関する改善が続いています。最新版では編集機能が拡充されているため、導入時にgog slides --helpで実際のサブコマンドを確認してください。
この違いは実務で意外とハマりやすいポイントなので、スライド自動化を検討している場合は事前に確認してください。
Claude Codeとの連携比較
両ツールをClaude Codeのスキルとして組み込んだ場合の実際の使い勝手を比較します。
gogcliスキルの実際の活用例
あるメディアサイトで、Claude Codeにgogcliスキルを組み込んで以下の自動化を実現しました。
事例1: 毎朝7:30の予定通知
Claude Codeのcronジョブを使い、毎朝gog calendar list --todayを実行。取得した予定をSlackの指定チャンネルに通知する自動化ルーティンを構築しました。実装は以下のような流れです。
# cronジョブで実行
gog calendar list --today --json | python3 -c "import sys,json; events = json.load(sys.stdin)['items']; ..." | curl -X POST $SLACK_WEBHOOK ...gogcliのコマンドが直感的なため、cronジョブのメンテナンスが容易でした。数週間後に別のメンバーがスクリプトを触ることになったときも、コマンドの意味が一目でわかり、修正がスムーズでした。
事例2: Gmail未読メールの要約Slack通知
gog gmail search "is:unread newer_than:1d"で未読メールを取得し、件名と送信者をSlackにまとめて通知するスキルも構築しました。優先度の高い案件を見落とさないようにするための実用的な自動化です。
gwsスキルの特性
gwsは全レスポンスが構造化JSONで返り、AIエージェントがGoogleサービスを操作するためのAgent Skillsが100以上付属しています（npx skills add https://github.com/googleworkspace/cliで一括導入可能）。Claude Codeにgwsを連携させると、自然言語でWorkspace操作を指示できるようになります。Gemini CLI向けの公式拡張も用意されています。
ただし、コマンド構文がAPIに忠実なため、スクリプトを手書きするよりもAIエージェント（Claude Code）に生成させて実行させる使い方がメインになります。
AI自動化パイプラインでの判断基準
| ユースケース | 推奨ツール | 理由 |
|---|---|---|
| 毎朝の予定・メール通知 | gogcli | コマンドが簡潔でcronに組み込みやすい |
| Workspaceデータの定期集計 | gogcli | --json出力でpipelineに流しやすい |
| Claude AgentによるWorkspace自動操作 | gws | 100以上のAgent Skills + JSON前提の設計 |
| Admin APIでのユーザー管理 | gws | Admin APIへの対応が完全 |
| スクリプトで複数API組み合わせ | gogcli | コマンドの読みやすさが保守性に直結 |
Claude Codeを使ったGoogle Workspace連携の設定や自動化については、個別にご相談いただけます。認証設定から実際のスキル構築まで、段階的にサポートしています。
どちらを選ぶべきか — 用途別の判断基準
実際に両ツールを使った経験から、選定の判断フレームワークをまとめます。
gogcliを選ぶべきシーン
以下に該当する場合はgogcliが最適です。
-
Gmail・Calendar・Drive中心の自動化を構築したい 日常業務の自動化では、Gmail検索・カレンダー取得・Driveアップロードの3操作で8割がカバーできます。gogcliはこれらを最もシンプルなコマンドで実現できます
-
複数人でスクリプトをメンテナンスする ラッパー構文のため、APIの詳細を知らないメンバーでもコマンドの意味が読み取れます。チームでの保守コストが低い
-
cron連携やシェルスクリプトに組み込む テキスト形式・JSON形式を切り替えられる設計がシェルスクリプトとの相性が良いです
-
安定性を重視する gogcliもv1.0未満（2026年9月時点でv0.40.0）ですが、2026年3月から9月まで継続的にリリースが続いています。gwsはREADMEに「v1.0に向けて破壊的変更がありうる」と明記されています
gwsを選ぶべきシーン
以下に該当する場合はgwsを選びます。
-
Admin APIでのユーザー・グループ管理が必要 組織のGoogle Workspace管理（ユーザー作成・権限変更・グループ管理）は、gwsがAdmin API対応で優位です
-
Agent SkillsでClaude Codeなどのエージェントに組み込む gws付属の100以上のAgent Skillsを導入すると、Claude Codeが自然言語でGoogleサービスを操作できるエージェント構成を最小コストで実現できます
-
GoogleがAPI追加した際に即座に対応したい gwsはDiscovery APIの動的生成により、Google Workspaceの新機能が追加された翌日から使えます
-
AIエージェントに作業させる前提で使う JSONファースト設計でAIの後処理が前提の設計。Agent Skillsで定型操作をエージェントに任せる場合に最適です
両方インストールして使い分ける現実的な運用
実際の現場では「どちらか一方」ではなく、用途に応じて使い分けるのが合理的な選択です。
# 日常業務のルーティン（gogcli）
gog calendar list --today # 朝の予定確認
gog gmail search "is:unread" # 未読メール確認
gog tasks add "タスク名" # タスク追加
# AI連携・Admin操作（gws）
gws admin users list # ユーザー管理
# Agent Skillsを一括導入
npx skills add https://github.com/googleworkspace/cliインストールが競合することはなく、認証も独立して管理されます。まずgogcliで始め、Admin APIやAgent Skills連携が必要になったらgwsを追加するという段階的なアプローチを推奨します。
よくある質問
Q. gogcliとgwsはどちらが初心者向けですか？
gogcliのほうが初心者向けです。gog gmail searchのように英語の動詞が連なる直感的な構文で、GoogleのAPIドキュメントを読まなくても使い始めることができます。一方、gwsはGoogle APIの構造を理解していると使いやすいですが、初めて触れる方には少し学習コストがかかります。
Q. gws CLIはまだ不安定ですか？本番利用できますか？
2026年9月14日時点の最新版はv0.22.5（3月31日リリース）で、v1.0に向けて開発中です。公式READMEにも「破壊的変更あり」と明記されています。日常業務の自動化をクリティカルなフローに組み込む場合はバージョンを固定して使うか、gogcliを選んだほうが安全です。Agent Skills目的での利用は問題なく行えます。
Q. gogcliとgwsを同時にインストールしても問題ありませんか？
問題なく共存できます。コマンド名がそれぞれgogとgwsで異なるため、競合は発生しません。認証情報もKeychainや各ツール固有のディレクトリに独立して保存されます。
Q. Claude Codeでどちらかだけ使うとしたら？
Claude Codeのスキルとして組み込む場合、最初の1本はgogcliを推奨します。スキルファイルを書く際にgog gmail search "is:unread"のようなシンプルなコマンドのほうが記述しやすく、Claude Codeが正確に解釈しやすいです。Workspaceの本格的なエージェント化を目指す段階でgwsのAgent Skills連携を追加するという順序が効果的です。
＼ 業務自動化のお悩みをAI顧問に相談できます ／
AI顧問の無料相談はこちらまとめ
gogcliとgwsはどちらも「Claude CodeからGoogle Workspaceを操作する」ためのCLIツールですが、設計思想と得意分野が異なります。
- gogcli: 人間が読みやすいラッパー構文、27サービス対応（最新v0.40.0）。Gmail・Calendar・Driveの日常業務自動化に最適
- gws: Google（googleworkspace）公開のRust製動的CLI。25サービスを標準列挙し、未掲載APIも
<api>:<version>指定で呼べる。100以上のAgent Skills付属で、AI連携・Admin API・全API対応が強み - 使い分けの原則: 日常業務の自動化・チーム運用にはgogcli、AI連携パイプライン・Admin操作・Agent Skills連携にはgws
まずgogcliで始めて、必要に応じてgwsを追加するというアプローチが、導入コストと機能の両立において最も現実的です。
Claude Codeの導入・活用をサポートします
株式会社Nexaでは、Claude Codeを含む生成AIの導入・活用を支援するAI顧問・受託開発を提供しています。gogcliやgwsを使ったGoogle Workspace連携の設定から、社内業務の自動化フロー構築まで、「何から始めればいいかわからない」という段階からご支援いたします。
法人向けAI導入・活用の月額伴走サービス
AI導入の疑問を、週1回のMTGで相談できる「AI顧問」
株式会社Nexaでは、ChatGPT・Claude・Claude CodeなどのAI導入に関する質問や、社内活用・業務自動化の進め方を週1回相談できる 月額5万円からのAI顧問サービス を提供しています。
「自社では何から始めるべきか」「この業務はAI化できるか」「どのツールを選ぶべきか」を、無料相談で整理します。
