gmail-workflows 是做什麼的？
使用智慧化工作流程自動化 Gmail - 附件管理、郵件整理、自動歸檔以及 Google Drive 整合
功能
- 附件管理：從郵件中下載附件並儲存至 Google Drive 指定資料夾。
- 郵件整理：根據寄件者、主題關鍵字或標籤規則，自動移動郵件至標籤或執行其他動作。
- 自動歸檔：設定條件（例如來自特定網域的郵件）自動歸檔，減少收件匣雜亂。
- Google Drive 整合：將附件或郵件內容直接建立為 Google Drive 檔案。
前置需求
- 啟用 Gmail API 與 Google Drive API（可透過 Google Cloud Console 設定）。
- 取得 OAuth 2.0 用戶端憑證（Client ID 與 Client Secret），並設定授權重新導向 URI。
- 使用者必須授權 AI 代理存取其 Gmail 帳號與 Google Drive 帳號。
使用方式
-
初始化 OAuth 2.0 授權流程以取得存取權杖。
-
使用以下指令呼叫技能功能：
/gmail-workflows list --max-results 10 /gmail-workflows archive --query "from:[email protected]" /gmail-workflows save-attachment --message-id <郵件ID> --folder "發票" -
進階工作流程可以串聯多個步驟：
/gmail-workflows workflow "自動歸檔行銷郵件並備份附件"
授權與憑證
- 將
credentials.json放置於專案根目錄（從 Google Cloud Console 下載）。 - 第一次執行時會開啟瀏覽器要求授權，權杖會自動儲存為
token.json。 - 環境變數
GMAIL_WORKFLOWS_CLIENT_ID與GMAIL_WORKFLOWS_CLIENT_SECRET可取代credentials.json。
支援的平台
- Claude Code
- Cursor
- Codex
- 其他支援 MCP（Model Context Protocol）的工具
注意事項
- 請確保遵守 Google 的服務條款與隱私權政策。
- 此技能不會永久刪除郵件，只會歸檔或移動至標籤。
- 建議定期檢閱授權權杖的有效性並更新。