Google Workspace CLI：用指令與 AI 操作 Gmail，Drive，Calendar

如果你想讓 AI 或腳本操作 Gmail，Drive 與 Calendar，Google Workspace CLI 可以用同一套 gws 命令連接多個 Workspace API，並以結構化 JSON 回傳結果，不必為每個 Google 服務另外做一套整合。

它能替你完成什麼

你可以列出近期 Drive 檔案，建立試算表，讀取行事曆，查詢 Gmail，或建立 Chat 訊息。gws 不是把所有 API 命令寫死在程式內，而是從 Google Discovery Service 動態建立命令與參數，因此能覆蓋多個 Workspace 服務。

對自動化流程而言，結構化 JSON，auto-pagination，schema 查詢與明確 exit code 很實用。對 AI agent 而言，專案還提供 40 個以上的 skills，讓 agent 可以把自然語言任務轉成可檢查的 Workspace 操作。

你需要準備什麼

• Google 帳號，以及有權存取的 Workspace 資料。
• Google Cloud project 和 OAuth credentials。
• 對應作業系統的預編譯執行檔；若透過 npm 安裝則需要 Node.js 18 以上。
• 僅足以完成任務的 OAuth scopes，不要一次開啟所有權限。

第一次怎麼使用

安裝後先執行 gws auth setup 與 gws auth login，再從唯讀命令開始，例如列出五個 Drive 檔案。確認帳號，project 與回傳資料都正確後，才測試建立或修改內容。

對任何會寄信，建立檔案，修改行事曆或發送 Chat 訊息的命令，先加上 --dry-run 預覽請求。讓 AI agent 操作時，應要求它先顯示目標帳號，資源 ID，變更內容與所需 scope，取得確認後才執行寫入。這比只在提示詞中說「小心一點」更能降低誤操作。

哪些情況不適合

如果只是偶爾手動查看一封信或一個檔案，直接使用 Workspace 網頁介面更簡單。公司管理員也不應在未審核 OAuth app，service account，scope 與稽核紀錄前，把整個 Workspace 開放給 agent。

官方明確說明此專案不是正式支援的 Google 產品，而且仍在 v1.0 前的積極開發階段，可能出現破壞性變更。Discovery 文件，API 啟用狀態，OAuth 測試模式與 scope 限制也可能造成命令失敗。AI 讀取郵件或文件時還要防範內容中的提示注入，不能把外部文字直接當成系統指令。

來源與授權

本頁介紹 Google Workspace GitHub 組織下的 googleworkspace/cli，採 Apache License 2.0。查核時最新 Release 為 v0.22.5。官方 README 同時標示「not an officially supported Google product」以及 v1.0 前可能有 breaking changes。