gogcli vs gws 徹底比較｜Claude CodeでGoogle Workspace操作するならどちら？

この記事の著者

株式会社Nexa 代表取締役川島 陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社（旧 株式会社クニエ）にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

詳しく見る無料相談をする

Claude CodeからGoogle WorkspaceのGmail・Calendar・Driveを操作できると、業務自動化の幅が大きく広がります。しかし実際に試そうとすると、「gogcliとgwsのどちらを使えばいいのか」という疑問にぶつかることが多いです。

この記事では、両ツールを実際にセットアップして使用した経験をもとに、コマンド構文・対応サービス・Claude Code連携での違いを整理します。どちらを選ぶべきかの判断基準も具体的に示すので、導入前の検討材料としてお役立てください。

gogcliとgwsの基本的な違い

結論から言えば、2つのツールは「設計思想が根本的に異なる」ために生まれた選択肢です。一言で言うと、gogcliは「人間が使いやすい高品質なラッパーCLI」、gwsは「Google APIを直接呼び出す動的なCLI」という位置づけです。

gogcliとは

gogcliは、Peter Steinberger氏（@steipete）がGo言語で開発したオープンソースのCLIツールです。Gmail・Calendar・Drive・Sheets・Contacts・Tasksなど16以上のGoogle WorkspaceサービスをシンプルなコマンドでCLI操作できます。

コマンド構文は人間が読みやすい「ラッパー形式」で設計されています。

# Gmail検索gog gmail search "from:example.com is:unread"# 今日の予定取得gog calendar list --today# Driveにファイルをアップロードgog drive upload ./report.pdf --folder "月次レポート"

CLI操作に慣れていない方でも、コマンドを見ただけで何をしているかが直感的に理解できます。認証はOAuth2で管理されており、複数アカウントの使い分けも可能です。

gwsとは

gwsはGoogleが2026年3月に公式公開したRust製のCLIツールです（Apache 2.0ライセンス、v0.3.3）。最大の特徴は「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はMCPサーバーとしても動作でき、Claude CodeをはじめとするAIエージェントがworkspaceを操作するための100以上のAgent Skillsファイルが付属しています。ただし、執筆時点（2026年3月）でv1.0未達のため、今後も破壊的変更が加わる可能性があります。

コマンド構文と操作感の違い

同じ操作を実現するコマンドを比較すると、両ツールの思想の違いが明確になります。

主要操作のコマンド比較

gogcliは人間が直感的に使いやすい設計。gwsはAPIに忠実な設計でスクリプト・AI連携向きです。

出力形式の違い

gogcliの出力:

$ gog calendar list --today9: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エージェントやシェルスクリプトでの後処理が前提の設計です。

対応サービス・機能の比較

対応サービス一覧

注意点：gogcliのSlides対応は限定的

実際にgogcliでGoogleスライドの編集（画像差し替え・スライド内容の変更）を試みると、対応しているのは「エクスポート・コピー・メタデータ取得・新規作成」のみです。スライドの内容を直接編集したい場合は、gwsのGoogle Slides APIを直接呼び出すか、pptxでエクスポートしてローカルで編集→再アップロードという代替手順が必要です。

この違いは実務で意外とハマりやすいポイントなので、スライド自動化を検討している場合は事前に確認してください。

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はMCPサーバーとして動作できるため、Claude DesktopやAPIで使う際の統合がよりシームレスです。AIエージェントがGoogleサービスを操作するためのAgent Skillsが100以上付属しており、Claude Codeにgwsを連携させると、自然言語でWorkspace操作を指示できるようになります。

ただし、コマンド構文がAPIに忠実なため、スクリプトを手書きするよりもAIエージェント（Claude Code）に生成させて実行させる使い方がメインになります。

AI自動化パイプラインでの判断基準

Claude Codeを使ったGoogle Workspace連携の設定や自動化については、個別にご相談いただけます。認証設定から実際のスキル構築まで、段階的にサポートしています。

法人向けClaude Code個別指導の無料相談はこちら｜まずはお困りごとをプロに相談

どちらを選ぶべきか — 用途別の判断基準

実際に両ツールを使った経験から、選定の判断フレームワークをまとめます。

gogcliを選ぶべきシーン

以下に該当する場合はgogcliが最適です。

• Gmail・Calendar・Drive中心の自動化を構築したい 日常業務の自動化では、Gmail検索・カレンダー取得・Driveアップロードの3操作で8割がカバーできます。gogcliはこれらを最もシンプルなコマンドで実現できます

• 複数人でスクリプトをメンテナンスする ラッパー構文のため、APIの詳細を知らないメンバーでもコマンドの意味が読み取れます。チームでの保守コストが低い

• cron連携やシェルスクリプトに組み込む テキスト形式・JSON形式を切り替えられる設計がシェルスクリプトとの相性が良いです

• 安定性を重視する gogcliはv1.0以上のリリースで動作が安定しています。gwsはv0.3.3時点で破壊的変更が発生する可能性があります

gwsを選ぶべきシーン

以下に該当する場合はgwsを選びます。

• Admin APIでのユーザー・グループ管理が必要 組織のGoogle Workspace管理（ユーザー作成・権限変更・グループ管理）は、gwsがAdmin API対応で優位です

• MCPサーバーとしてClaude Agentに組み込む gwsのMCP server modeを使うと、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          # ユーザー管理# MCPサーバー起動gws serve --mcp

インストールが競合することはなく、認証も独立して管理されます。まずgogcliで始め、Admin APIやMCP連携が必要になったらgwsを追加するという段階的なアプローチを推奨します。

よくある質問

Q. gogcliとgwsはどちらが初心者向けですか？

gogcliのほうが初心者向けです。gog gmail searchのように英語の動詞が連なる直感的な構文で、GoogleのAPIドキュメントを読まなくても使い始めることができます。一方、gwsはGoogle APIの構造を理解していると使いやすいですが、初めて触れる方には少し学習コストがかかります。

Q. gws CLIはまだ不安定ですか？本番利用できますか？

執筆時点（2026年3月）でgwsはv0.3.3です。v1.0に向けて開発中であり、公式ドキュメントでも「破壊的変更あり」と明記されています。日常業務の自動化をクリティカルなフローに組み込む場合はバージョンを固定して使うか、gogcliを選んだほうが安全です。MCPサーバーやAgent Skills目的での利用は問題なく行えます。

Q. gogcliとgwsを同時にインストールしても問題ありませんか？

問題なく共存できます。コマンド名がそれぞれgogとgwsで異なるため、競合は発生しません。認証情報もKeychainや各ツール固有のディレクトリに独立して保存されます。

Q. Claude Codeでどちらかだけ使うとしたら？

Claude Codeのスキルとして組み込む場合、最初の1本はgogcliを推奨します。スキルファイルを書く際にgog gmail search "is:unread"のようなシンプルなコマンドのほうが記述しやすく、Claude Codeが正確に解釈しやすいです。Workspaceの本格的なエージェント化を目指す段階でgwsのMCP連携を追加するという順序が効果的です。

まとめ

gogcliとgwsはどちらも「Claude CodeからGoogle Workspaceを操作する」ためのCLIツールですが、設計思想と得意分野が異なります。

• gogcli: 人間が読みやすいラッパー構文、16サービス対応、安定版。Gmail・Calendar・Driveの日常業務自動化に最適
• gws: Google公式のRust製動的CLI、21サービス以上対応、MCP server対応。AI連携・Admin API・全API対応が強み
• 使い分けの原則: 日常業務の自動化・チーム運用にはgogcli、AI連携パイプライン・Admin操作・MCP連携にはgws

まずgogcliで始めて、必要に応じてgwsを追加するというアプローチが、導入コストと機能の両立において最も現実的です。