# Google Workspace CLI：ターミナルからGmail、Drive、Calendarを自動化する > Google Workspace CLI（gws）をインストールして使ってGmail、Drive、Calendar、Sheetsを自動化する方法を学びましょう。バイブコーディングのテンプレートと実際のワークフローの例付き。 - Source: https://www.8apps.co/ja/blog/google-workspace-gws-cli - Markdown: https://www.8apps.co/ja/blog/google-workspace-gws-cli.md - Published: 2026-03-25 - Author: 8appsチーム - Language: ja --- 毎日、何百万人もの人々が同じ非効率なゲームをしています。Gmailを開いてクリックして、別のタブでDriveを開いてファイルを検索し、Calendarに移動して何かをDocに貼り付けます。_まあ普通_ ですが — それはまた、合計すると何時間もの、二度と戻ってこない無数の小さなクリックでもあります。 2026年3月初旬に何かが変わりました。Googleがひっそりとツールをリリースしました。Gmail、Drive、Calendar、Sheets、Docs、Chat — これらすべてをターミナルの1行で操作できるツールです。`gws`と呼ばれ、最初の週でHacker Newsで500ポイント以上と22,000のGitHubスターを獲得して1位になりました。 これは開発者だけのものではありません。Googleワークスペースに_何かをやってほしい_ と思ったことがあって、設定に20分かけてもいいなら — ここが出発点です。 > ⚠️ **注意：** `gws`はv1以前で、Googleの公式サポートはありません。オープンソース（Apache 2.0）です。個人の自動化や実験には最適ですが、十分なテストなしに本番環境で使うことはお勧めしません。 --- ## Google Workspace CLIとは？ `gws`をGoogle Workspace全体のユニバーサルリモコンと考えてください。ブラウザで5つの異なるアプリを行き来する代わりに、コマンドを入力すると即座に構造化された結果が得られます。ローディング画面なし。クリックなし。タブ切り替えなし。 本当に賢いところ：固定されたコマンドリストを提供する代わりに、実行時にGoogleのDiscovery Serviceを読み取り、コマンドサーフェスをオンザフライで構築します。つまりGoogleが新しいAPIエンドポイントを追加すると、`gws`はパッケージの更新なしに自動的にそれを取り込みます。すべてのレスポンスは構造化JSONとして返され、AIエージェント、シェルスクリプト、きれいなデータを読むものなら何でもと相性抜群です。 | サービス | 自動化できること | | ---------------- | ------------------------------------------------- | | 📬 Gmail | メールのリスト、検索、送信、返信、トリアージ | | 📁 Drive | ファイルのアップロード、リスト、検索、作成 | | 📅 Calendar | アジェンダの取得、イベント作成（タイムゾーン対応） | | 📊 Sheets & Docs | 範囲の読み取り、行の追加、ドキュメントの作成 | | 💬 Chat | スペースやユーザーへのメッセージ送信 | | 🤖 AIエージェント | 100以上の組み込みスキルと組み込みMCPサーバー | --- ## パワーユーザーの実際の使い方 ### 月曜日の朝の受信トレイブリーフィング ローンチ以降で最もよく引用されるユースケースです。Gmailを開いて未読メールに溺れる代わりに、AIエージェント（Claude Code、Gemini CLI、またはターミナルコマンドを実行できるもの）を接続して受信トレイを自動的に処理しています： > **AIエージェントへのプロンプト：** > 最後の10通のメールを読んでください。それぞれについて、緊急か、アクションが必要か、単に情報提供かを判断してください。次に「エグゼクティブブリーフィング」というGoogleスライドデッキと「週次ブリーフィングノート」というGoogle Doc を作成し、送信者、優先度、締め切り、アクションアイテムの列を持つGoogleシートに10通全部を記録してください。 `gws`以前は、Zapierのワークフロー、3つの別々のAPI、デバッグに費やした週末が必要でした。今はすべてへのアクセスをすでに持つエージェントへの1つのプロンプトで済みます。 ### 契約書と文書のワークフロー エージェントが新しい契約書メールを読み、重要な条件を共有Google Docに抽出し、添付ファイルをDriveにファイルし、法務チームにChatでpingし、Calendarでレビュー期限にフラグを立てます — すべて1通の受信メールによってトリガーされます。この種のマルチステップ、クロスアプリの自動化は以前はカスタムAPIコードや高価なノーコードプラットフォームでのみ可能でした。 ### Workspace内フローでのZapierの置き換え Google Workspace内に完全に収まるワークフローには、`gws`が有料の自動化ツールを置き換えられます。操作ごとの料金なし、学ぶべきワークフロービルダーなし、プラットフォームロックインなし。コミュニティのメンバーはWorkspaceの自動化に毎月50〜100ドルかかるZapierプランを置き換えたと報告しています。 > ⚡ **主な制限：** `gws`はGoogle対Googleです。Salesforce、HubSpot、Slackが必要なワークフローは引き続きZapierまたはn8nが必要です。しかしWorkspace内に留まるワークフローには、毎月支払ってきた自動化レイヤーをカバーします。 --- ## 4ステップでのセットアップ ### ステップ1 — Node.jsをインストールしてからgwsをインストールする ターミナルで`node --version`と入力してNodeがあるか確認します。なければ[nodejs.org](https://nodejs.org)からダウンロードします。次を実行します： ```bash npm install -g @googleworkspace/cli # 正しくインストールされたことを確認 gws --version ``` ### ステップ2 — Google Cloudプロジェクトを作成する [console.cloud.google.com](https://console.cloud.google.com)にアクセスして新しいプロジェクトを作成し（名前は何でも可）、**APIとサービス → 認証情報 → OAuth 2.0クライアントIDを作成** に移動して **デスクトップアプリ** を選択します。JSONファイルをダウンロードします — それが鍵です。 すでに`gcloud` CLIがインストールされている場合は、これをすべてスキップして`gws auth setup`を実行するだけで、Cloudプロジェクトのセットアップ全体が自動的に処理されます。 ### ステップ3 — 認証する ```bash gws auth login # ブラウザが開く → アクセスを承認 → 完了 # 認証情報は暗号化されてOSのキーリングに保存される ``` > ⚠️ **テストモードのGmailアカウント：** Googleは未確認のアプリを約25のOAuthスコープに制限しています。スコープピッカーが表示されたら、「すべて選択」ではなく個別のサービス（GmailのみまたはDriveのみ）を選択してこの制限に引っかからないようにしてください。 ### ステップ4 — APIを有効にして最初のコマンドを実行する Cloud ConsoleダッシュボードでプロジェクトのSpecificなAPI（Drive、Gmailなど）を有効にしてから、最初のコマンドを試します： ```bash # Google Driveのファイルをリスト gws drive files list # 上位10件の結果に制限する gws drive files list --params '{"pageSize": 10}' # 近日中のカレンダーイベントを確認する gws calendar events list --params '{"calendarId":"primary","maxResults":5}' # サービスで利用可能なすべてのコマンドを確認する gws gmail --help ``` --- ## 最初の自動化をバイブコーディングする スクリプトをゼロから書く必要はありません。平易な言語でやりたいことを説明し、Claude、ChatGPT、Geminiに貼り付ければ、数分で動くコードが返ってきます。すぐに使えるプロンプトを3つご紹介します。 ### テンプレート1 — 朝のメールダイジェスト ``` Google Workspace CLI（gws）を使って最後の20通の未読Gmailメッセージを JSONとして取得し、それぞれをClaudeを使って要約し、 出力をホームディレクトリにmorning-brief.mdとして保存するbashスクリプトを書いてください。 メールごとに送信者、件名、1文の要約を含めてください。 ``` ### テンプレート2 — 添付ファイルを自動的にDriveにファイルする ``` gws（subprocessを使って）を使って過去7日間のPDF添付ファイルのある GmailメールをGmailで検索し、各添付ファイルをダウンロードして、 gws drive files createと--uploadフラグを使って「Inbox Attachments」という Google Driveフォルダーにアップロードするpythonスクリプトを書いてください。 ``` ### テンプレート3 — 週次Sheetsレポート（cron対応） ``` 毎週金曜日の午後5時にcronで実行できるbashスクリプトを書いてください。 gwsを使ってGoogleシート（ID：YOUR_ID_HERE）に今日の日付、 今週受け取ったメール数（gws gmailから）、 今週のカレンダーイベント数（gws calendarから）の行を追加してください。 ``` > 💡 **良い結果を得るコツ：** 常にAIに（1）ターゲットにしている`gws`サービス、（2）出力がJSONであること、（3）最終結果が正確に何か — ファイル、メール、Sheetsの行 — を伝えてください。最終状態について具体的なほど、より良いコードが返ってきます。 --- ## あなたはどのタイプのパワーユーザーですか？ | あなたのプロフィール | 最適な出発点 | | ------------------------------------------------------------- | ---------------------------------------------------- | | 📋 **オペレーション担当者** — プロセス管理、繰り返しの作業が嫌い | テンプレート3：週次チームレポートの自動化 | | ✉️ **受信トレイゼロ追求者** — Gmailに生きてメールに溺れる | `gws gmail +triage` + 朝のダイジェストスクリプト | | 📊 **データハンドラー** — いつもスプレッドシートにデータを取り込んでいる | `gws sheets` + 一括データ取得用`--page-all`フラグ | | 🤖 **AIティンカラー** — すでにClaude CodeやGeminiを使っている | MCPサーバー：`gws mcp -s drive,gmail,calendar` | --- ## 始める前の正直な注意点 **v1以前です。** コマンド、フラグ、出力形式はリリース間で変わる可能性があります。重要なものを構築している場合は、特定のバージョンに固定してください：`npm install -g @googleworkspace/cli@x.x.x`。 **セットアップに約20〜30分かかります。** Google Cloudプロジェクトのステップが主な摩擦点です。`gcloud`がある場合は`gws auth setup`を使ってください — ほとんどを自動化してくれます。 **スコープ制限が個人のGmailアカウントに影響します。** テストモードでは、Googleは未確認のアプリを約25のOAuthスコープに制限します。スコープピッカーで「すべて」ではなく個別のサービスを選択してください。 **マルチプラットフォームツールではありません。** `gws`はGoogle のエコシステム内のすべてをカバーします。SlackやSalesforceなどの外部ツールに触れるワークフローには、引き続きコネクターレイヤーが必要です。 --- ## 今日始める インストールには1つのコマンド。何ヶ月も悩んでいたことを自動化するのに1週末。 - 🐙 [GitHubリポジトリ](https://github.com/googleworkspace/cli) - 📦 [npmパッケージ](https://www.npmjs.com/package/@googleworkspace/cli) - 📖 [エージェントスキルのドキュメント](https://github.com/googleworkspace/cli/blob/main/docs/skills.md) ```bash npm install -g @googleworkspace/cli ``` --- ## ノーコードがお好みですか？8appsのアドオンを試してください ターミナルコマンドが苦手な場合は、私たちの既製のアドオンを使ってGoogle Workspaceを自動化できます。複雑なセットアップなしにGmail、Sheets、Drive内でネイティブに動作します： - **[Contact Extractor](/ja/google-workspace/contact-extractor)**：GmailからGoogle Sheetsに氏名とメールアドレスを取り出して瞬時に営業リストを作成します。 - **[Currency Converter](/ja/google-workspace/currency-converter)**：Google Sheets内で直接ライブの為替レートを簡単に変換します。 - **[Drive Guard](/ja/google-workspace/drive-guard)**：Google Drive全体でファイル権限を安全に監査・管理します。 - **[GPT Mate](/ja/google-workspace/gpt-mate)**：Google DocsとSheetsにChatGPTとGeminiを直接組み込んでメールとコンテンツを自動的に下書きします。 - **[Hash Data](/ja/google-workspace/hash-data)**：Google Sheetsのデータをすばやくハッシュ化して機密情報とPIIを保護します。 - **[Mail My Sheets](/ja/google-workspace/mail-my-sheets)**：スケジュールに従ってSheetsのスナップショットをメールで送ることでレポーティングを自動化します。 - **[Mail to Drive](/ja/google-workspace/mail-to-drive)**：重要なメールと添付ファイルをPDFとして自動的にDriveに保存して記録を守ります。 **カスタムワークフローをお持ちですか？** ビジネスプロセスに合わせた独自のGoogle Workspaceアドオンを構築できます。始めるには[support@8apps.co](mailto:support@8apps.co)にお書きください！