Google Workspace CLI:ターミナルからGmail、Drive、Calendarを自動化する

8appsチーム·

Google Workspace CLI(gws)をインストールして使ってGmail、Drive、Calendar、Sheetsを自動化する方法を学びましょう。バイブコーディングのテンプレートと実際のワークフローの例付き。

毎日、何百万人もの人々が同じ非効率なゲームをしています。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からダウンロードします。次を実行します:

npm install -g @googleworkspace/cli

# 正しくインストールされたことを確認
gws --version

ステップ2 — Google Cloudプロジェクトを作成する

console.cloud.google.comにアクセスして新しいプロジェクトを作成し(名前は何でも可)、APIとサービス → 認証情報 → OAuth 2.0クライアントIDを作成 に移動して デスクトップアプリ を選択します。JSONファイルをダウンロードします — それが鍵です。

すでにgcloud CLIがインストールされている場合は、これをすべてスキップしてgws auth setupを実行するだけで、Cloudプロジェクトのセットアップ全体が自動的に処理されます。

ステップ3 — 認証する

gws auth login
# ブラウザが開く → アクセスを承認 → 完了
# 認証情報は暗号化されてOSのキーリングに保存される

⚠️ テストモードのGmailアカウント: Googleは未確認のアプリを約25のOAuthスコープに制限しています。スコープピッカーが表示されたら、「すべて選択」ではなく個別のサービス(GmailのみまたはDriveのみ)を選択してこの制限に引っかからないようにしてください。

ステップ4 — APIを有効にして最初のコマンドを実行する

Cloud ConsoleダッシュボードでプロジェクトのSpecificなAPI(Drive、Gmailなど)を有効にしてから、最初のコマンドを試します:

# 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週末。

npm install -g @googleworkspace/cli

ノーコードがお好みですか?8appsのアドオンを試してください

ターミナルコマンドが苦手な場合は、私たちの既製のアドオンを使ってGoogle Workspaceを自動化できます。複雑なセットアップなしにGmail、Sheets、Drive内でネイティブに動作します:

  • Contact Extractor:GmailからGoogle Sheetsに名前、メールアドレス、電話番号を取り出して瞬時に営業リストを作成します。
  • Currency Converter:Google Sheets内で直接ライブの為替レートを簡単に変換します。
  • Drive Guard:Google Drive全体でファイル権限を安全に監査・管理します。
  • GPT Mate:Google DocsとSheetsにChatGPTとGeminiを直接組み込んでメールとコンテンツを自動的に下書きします。
  • Hash Data:Google Sheetsのデータをすばやくハッシュ化して機密情報とPIIを保護します。
  • Mail My Sheets:スケジュールに従ってSheetsのスナップショットをメールで送ることでレポーティングを自動化します。
  • Mail to Drive:重要なメールと添付ファイルをPDFとして自動的にDriveに保存して記録を守ります。

カスタムワークフローをお持ちですか?
ビジネスプロセスに合わせた独自のGoogle Workspaceアドオンを構築できます。始めるにはsupport@8apps.coにお書きください!