gogcli入門 — Claude CodeからGoogle Workspaceを丸ごと操作する方法

この記事の著者

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

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

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

Claude CodeにgogcliというCLIツールを組み合わせると、Gmail・Googleカレンダー・Google Drive・スプレッドシートなど10以上のGoogle Workspaceサービスを、ブラウザを一切開かずにターミナルから操作できます。

「AIに指示するだけでメールの確認・予定の確認・ファイルの整理まで完結させたい」という要望は多いものの、MCP（Model Context Protocol）の設定に手間取るケースは少なくありません。gogcliであれば、MCP設定は不要です。インストールしてOAuth認証を通すだけで、Claude CodeのBashツールから直接コマンドを呼び出せるようになります。

この記事では、gogcliの概要から導入手順、実務での活用事例まで、実際のプロジェクトで得た知見をもとに解説します。

gogcliとは？10のGoogle Workspaceサービスを操作するCLI

gogcliは、Google Suite（現 Google Workspace）の各サービスをコマンドラインから操作するためのオープンソースCLIツールです。Go言語で実装されており、MIT Licenseのもとで公開されています。コマンド名は gog で、単一のバイナリから10以上のサービスを統一的に操作できます。

対応しているサービス一覧

gogcli v0.9.0時点で対応しているサービスは以下のとおりです。

すべてのサービスに対して --json フラグが使えるため、出力をパースして他のコマンドに渡したり、Claude Codeが結果を読み取って次のアクションを決定するといった連携が容易に実現できます。

なぜMCP不要でClaude Codeと連携できるのか

Claude CodeはBashツールを内蔵しており、ターミナルコマンドを直接実行できます。gogcliは標準的なCLIツールとして設計されているため、Claude Codeが gog gmail search "is:unread" のようなコマンドを生成・実行し、その出力を読み取って自然言語で回答することが可能です。

MCP経由での連携も技術的には可能ですが、gogcliの場合はMCPサーバーの起動やツール定義の設定が不要なぶん、導入のハードルが大幅に下がります。「インストールして認証するだけ」という手軽さが、実務での活用しやすさにつながっています。

gogcliのインストールとOAuth認証設定

インストールコマンド

macOSの場合、Homebrewでインストールできます。tap名の指定が必須な点に注意してください。

brew install steipete/tap/gogcli

インストール後、バージョンを確認します。

gog --version

OAuth認証の設定手順

gogcliを使うには、GoogleアカウントのOAuth認証が必要です。以下の手順で設定します。

1. 認証コマンドを実行してブラウザを開く
2. Googleアカウントでログインして「許可」を選択
3. 認証完了後、ターミナルに戻って確認

# 認証を追加（初回）gog auth add your-email@example.com# 認証状態の確認gog auth status

実際にセットアップを行った際、macOSのKeychainがロックされている状態では認証情報の保存に失敗することがありました。その場合は以下を試してください。

# Keychainをアンロック（macOSログインパスワードを入力）security unlock-keychain ~/Library/Keychains/login.keychain-db

Keychainのアンロック後に再度 gog auth add を実行すると、正常に認証情報が保存されます。

動作確認

認証が完了したら、簡単なコマンドで動作を確認します。

# 今日の予定を確認gog calendar events --today --all# 未読メール5件を確認gog gmail search "is:unread" --max 5# Driveのファイル一覧gog drive ls

これらのコマンドが正常に動作すれば、gogcliの設定は完了です。Claude Codeからも同様のコマンドを呼び出せるようになっています。

基本コマンドリファレンス — Gmail・Calendar・Driveを操作する

日常業務でよく使うコマンドをまとめます。

Gmailの操作

# 未読メールの検索gog gmail search "is:unread" --max 10# 特定の送信者からのメールを検索gog gmail search "from:client@example.com" --max 5# 件名で絞り込みgog gmail search "subject:見積もり" --max 5# JSONで出力（スクリプト連携用）gog gmail search "is:unread" --json --max 5

Google Calendarの操作

# 今日の予定を一覧表示gog calendar events --today --all# 今週の予定を確認gog calendar events --this-week# 新しい予定を作成gog calendar create \  --title "定例ミーティング" \  --start "2026-03-27T10:00:00" \  --end "2026-03-27T11:00:00"

Google Driveの操作

# ファイル一覧の確認gog drive ls# ファイルを特定フォルダにアップロードgog drive upload /path/to/file.pdf --parent FOLDER_ID# ファイルを検索gog drive search "契約書"# 共有リンクの生成gog drive share FILE_ID --role reader --type anyone

これらのコマンドはClaude Codeから自然言語で指示しても実行できます。「今日の予定を教えて」「未読メールを確認して」と伝えるだけで、Claude Codeが適切なgogcliコマンドを組み立てて実行します。

各サービスを単独で深掘りした記事もご覧ください。Claude Code × Gmailで受信メールを自動チェック・要約する方法では、Gmailの実践的な活用パターンを詳しく解説しています。

実践例①：Driveへのファイル一括格納を自動化する

あるメディアサイトの制作物を管理していた際、公開済みコンテンツのアーカイブをGoogle Driveに整理する作業が発生しました。ローカルには5つのカテゴリフォルダに分かれた合計92ファイルが存在していました。手作業でのアップロードは非現実的だったため、gogcliとClaude Codeを組み合わせて対応しました。

フォルダ構成を設計してDrive上に自動作成

まずDriveの指定フォルダ内に、ローカルの構成と同じフォルダ群を作成しました。

# Drive上にカテゴリフォルダを作成gog drive mkdir "カテゴリA" --parent TARGET_FOLDER_IDgog drive mkdir "カテゴリB" --parent TARGET_FOLDER_IDgog drive mkdir "カテゴリC" --parent TARGET_FOLDER_ID

フォルダの作成は成功しましたが、gogcliのアップロードコマンド（gog drive upload）は単一ファイル単位の操作のみ対応しており、フォルダ丸ごとのアップロードには対応していませんでした。

複数ファイルの一括アップロード手順

この制限を回避するため、Claude Codeにシェルスクリプトを生成させ、ファイルを1件ずつループ処理でアップロードしました。

# カテゴリAフォルダ内の全ファイルをアップロードfor file in /path/to/local/カテゴリA/*; do  gog drive upload "$file" --parent DRIVE_FOLDER_ID_A  echo "アップロード完了: $file"done

このアプローチで92ファイルすべてのアップロードが完了しました。ツールの制限に当たった際でも、Claude Codeがシェルスクリプトで補完する柔軟な対処ができる点が、実務での使いやすさにつながっています。

実務での活用ポイントgogcliでフォルダ単位のアップロードができない場合は、for ループでファイルを1件ずつ処理するスクリプトに切り替えましょう。Claude Codeに「このフォルダのファイルを全部アップロードして」と伝えれば、このパターンを自動的に生成してくれます。

Claude Codeの導入や活用方法について、個別にご相談いただけます。「どの機能から使えばいいか」「自社業務への適用方法を知りたい」といった段階から対応しています。

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

実践例②：Googleカレンダーの予定をSlackに毎朝自動通知する

「毎朝その日のスケジュールをSlackで確認したい」という要件に対して、OpenClawのcronジョブとgogcliを組み合わせて実装しました。Googleカレンダーとの連携についてはClaude CodeでGoogleカレンダーの予定を毎朝自動通知する方法でも詳しく解説しています。

cronジョブの作成手順

OpenClawのcron設定ファイルにジョブを追加します。毎日9:00（JST）に gog calendar events --today --all を実行し、結果を整形してSlackのDMに送信する構成です。

{  "id": "daily-calendar-notify",  "schedule": "0 9 * * *",  "enabled": true,  "prompt": "gogcliを使って本日のGoogleカレンダーの予定を取得し、時間順に整理してSlackのDMに送信してください。予定がない場合は「今日の予定はありません」と送信してください。"}

このジョブにより、毎朝Slack DMに以下のような通知が届くようになりました。

📅 今日の予定（2026年3月2日 月曜日）- 11:00〜11:30  定例ミーティング (Meet付き) ✅ 終了済み- 15:00〜16:00  クライアント相談 (Meet付き)

Slack通知が届かない場合のトラブルシューティング

実際の設定では、announce配信方式でSlack通知が届かない問題（channel_not_found エラー）が発生しました。原因はOpenClawのannounce配信メカニズムがDMチャンネルIDを正しく解決できていないことでした。

この問題はcronジョブの配信モードを "none" に変更し、エージェント自身がcurl + Slack APIで直接DMに投稿する方式に切り替えることで解決しました。

# Slack API直接呼び出しで投稿curl -X POST https://slack.com/api/chat.postMessage \  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \  -d '{"channel": "DM_CHANNEL_ID", "text": "本日の予定..."}'

cronジョブ内でSlack通知を実装する際は、フレームワークのannounce機能に依存せず、Slack APIを直接呼び出す方式の方が安定しています。

実務での活用ポイントcronジョブでSlack通知が届かない場合は、OpenClawのopenclaw cron editコマンドで設定を更新し、配信方式をnoneにした上でエージェント内でSlack APIを直接呼び出してください。ゲートウェイの再起動後にテスト実行して、正常に配信されることを確認しましょう。

gwsとgogcliの使い分け — どちらを選ぶべきか

2026年3月2日、Googleから公式のGoogle Workspace CLI「gws」がリリースされました。gogcliとgwsは目的が似ていますが、設計思想や対応範囲が異なります。実際に両方を使って比較した経験をもとに整理します。

機能・構文・認証方式の比較表

実際にgwsを設定した際、OAuthスコープの追加（手動で85スコープの設定が必要との報告）やgcloud CLIへの依存など、初期設定に相当な手間がかかる点が課題として浮かび上がりました。一方のgogcliは数分で認証が完了し、すぐに使い始められます。

gogcliが向く場面 / gwsが向く場面

gogcliが向く場面:– すぐに使い始めたい（認証設定を最小化したい）- Gmail・Calendar・Drive・Sheetsの基本操作だけ使えれば十分- Claude CodeやAIエージェントからシンプルに呼び出したい

gwsが向く場面:– Google Apps Scriptのデプロイ・実行まで管理したい- 21サービスを使い分ける高度な自動化を実現したい- ページネーション処理が必要な大量データを扱う

日常的な業務自動化（メール確認・カレンダー通知・Driveファイル管理）にはgogcliで十分対応できます。より高度なワークフローや未対応サービスが必要になった際に、gwsへの移行を検討するとよいでしょう。

よくある質問

Q. gogcliとgwsの違いは何ですか？

gogcliはサードパーティ製の軽量CLIで、認証セットアップが簡単です。gws（Google公式）は21サービス対応でMCPにも対応しますが、初期設定が複雑です。まずgogcliから始めて、機能不足を感じたらgwsに移行する流れをおすすめします。

Q. OAuth認証の設定はどのくらいの時間がかかりますか？

gogcliの場合、brew installからOAuth認証完了まで5〜10分程度です。Keychainのロック状態に引っかかった場合は追加で数分かかりますが、security unlock-keychain コマンドで解決できます。

Q. Google Slidesの画像編集などもできますか？

現在のgogcliでは、スライドのエクスポート（PDF/PPTX）・新規作成・コピーは対応していますが、スライド内の画像差し替えやコンテンツ編集には対応していません。これらの操作が必要な場合は、Google Slides APIを直接呼び出すPythonスクリプトを用意するか、PPTXとしてエクスポードしてpython-pptxで編集する方法があります。

Q. 複数のGoogleアカウントを使い分けることはできますか？

対応しています。gog auth add で複数アカウントを登録でき、--account フラグで使用するアカウントを切り替えられます。法人アカウントと個人アカウントを用途に応じて使い分けることが可能です。

まとめ

gogcliを導入すると、Claude CodeからGmail・Googleカレンダー・Google Drive・Sheetsなど10サービスをMCP設定なしでCLI操作できます。

本記事で解説した実践ポイントを振り返ります。

• インストール: brew install steipete/tap/gogcli でインストール後、OAuth認証を通すだけで即日利用開始できる
• 実務活用①: ローカルファイルのDriveへの一括格納は、フォルダ作成→ループ処理でのアップロードという2段階で実現できる
• 実務活用②: cronジョブ + gogcliでカレンダー予定の毎朝Slack通知を自動化できる。Slack通知は配信フレームワークに依存せず直接API呼び出しを推奨
• gwsとの使い分け: 日常的な業務自動化にはgogcliで十分。高度なワークフローにはgwsへの移行を検討

まず brew install steipete/tap/gogcli を実行してインストールし、gog calendar events --today で今日の予定を取得してみてください。Claude Codeと組み合わせることで、Google Workspaceの操作が大幅に効率化されます。

詳細な設定方法やスキルのカスタマイズは、個別相談でご案内しています。