📅 GWS CLI
跟 Google Workspace 對話，不用再手動開日曆點半天。查行程、寄信、找檔案一句話搞定，AI 員工也能直接呼叫。
📅 發布：2026-08-26 ｜ 🔄 最後更新：2026-08-26
一句話定位：一個指令工具，把 Google 日曆／信箱／雲端硬碟／表單全部串起來，你跟 AI 員工說一句話就能查、能寫
為什麼用
查一次今天的行程，你原本要做幾件事：打開瀏覽器、輸入日曆網址、等頁面載入、找到今天的欄位、看有沒有衝突 — 五個動作，才回答一個最簡單的問題：「我今天幾點有事？」
Google Workspace 各個服務（日曆、信箱、雲端硬碟、表單、聊天）本來就有官方 API，但要 AI 員工直接呼叫，得先寫串接程式碼。GWS CLI 把這一層做好了：一句話下指令，它幫你轉成對應的 API 呼叫，還有自動分頁、--dry-run 請求預覽。寄信或寫入行事曆前，仍要核對帳號、收件人或目標行事曆，以及實際要送出的內容。
適合的痛：
- 查行程要開瀏覽器點半天
- 想請 AI 員工幫忙讀信、建行事曆事件，卻沒有安全的串接方式
- 每個 Google 服務都要學一套不同的操作邏輯
Cassie 怎麼用
她的系統把 GWS CLI 定為行程查詢的標準工具：
gws calendar +agenda— 跨日曆看近期行程，一句話問「今天幾點有事」- 要結構化資料就加
--format json，讓 AI 員工直接讀 - 查特定範圍用
gws calendar events list --params '{...}'（寫入類指令要用--json不是--params，這是她踩過的坑） - 對應到「Cassie 說『安排』就是要建真的行事曆事件」這條規則 — GWS CLI 是實際落地建事件的工具
對位 Cassie 系統
| 用途 | 對應方式 |
|---|---|
| 每日排程、查詢近期行程 | day-planner skill 開場先查行事曆 |
| 「安排」＝建真的 Google Calendar 事件 | 建事件前用 gws calendar 系列指令 |
| 主線任務排程協調 | 主線 PM 掌握節奏時查詢/寫入行事曆 |
| Google Workspace 資料查詢與寫入 | 查詢可依已授權範圍執行；寄信、建立行事曆事件等寫入，要先核對目標、內容與授權。 |
安裝
版本注意：官方倉庫明白寫這不是 Google 正式支援產品，目前仍在 1.0 版之前，升級可能出現不相容變更。安裝完先跑 gws --version 記錄你驗證過的版本。
macOS 用 Homebrew（推薦）：
brew install googleworkspace-cli或用 npm（會自動下載對應系統的執行檔）：
npm install -g @googleworkspace/cli第一次使用需要 Google Cloud 專案及 OAuth 憑證。已安裝並登入 gcloud 指令工具時，可由以下指令引導設定：
gws auth setup沒有 gcloud 時，請依專案官方的手動 OAuth 設定操作；gws auth setup 需要 gcloud，不能只裝好 GWS CLI 就直接完成。設定憑證後，仍須依官方步驟執行 gws auth login，確認授權的帳號與服務範圍。
不會打指令？複製這句話給你的 AI 員工（Claude Code）就好：
「先確認我的電腦能否使用 Homebrew，並核對 GWS CLI 官方安裝說明。安裝後請檢查有沒有已登入的
gcloud；有才帶我跑gws auth setup，沒有就帶我看官方手動 OAuth 設定。每一步先說明需要的帳號和權限，登入後再查一筆資料確認連線。」
學員實戰範例
場景：想知道今天還有什麼事沒處理
- 跟 AI 員工說「幫我看一下今天的行程」
- AI 員工呼叫
gws calendar +agenda - 直接列出今天所有日曆的事件，不用你自己開瀏覽器找
場景：想請 AI 員工幫忙把一件事排進行事曆
- 跟 AI 員工說「幫我安排明天下午 3 點開會」
- AI 員工先用
gws calendar events list查那個時段有沒有衝突 - 確認空檔後用
gws calendar events create（帶--json參數）建立事件 - 你打開日曆就看到那格已經排好，不用自己動手
相關工具
- 🛠️ 免費工具庫首頁 — 完整工具清單
- ☁️ CloudMounter — 同樣是「省下手動操作」思路，這個處理的是雲端硬碟同步