Google Workspace CLI
终端自动化Google Workspace管理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Google Workspace CLI。 它的用途是：终端自动化Google Workspace管理工具 完整的 Skill 内容见：https://321skill.com/skills/google-workspace-cli-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我搜索Gmail中最近7天来自客户support@example.com的邮件，提取附件并保存到Google Drive指定文件夹。' 它会调用gws mail search命令搜索邮件，再用gws drive upload将附件上传到目标文件夹，最终返回文件链接。
介绍
解决什么问题：该工具让您从终端直接操作Google Workspace的20+ API，包括Gmail、Drive、Calendar、Sheets、Docs和Admin SDK。当您需要批量搜索/发送邮件、上传/导出文件、管理日历事件、用户和群组，或遇到Google API调用返回403、invalid_grant、配额错误或空结果时，gws CLI提供了统一、稳定的命令行接口，避免手动处理API错误和重试逻辑。
怎么用：安装后，通过gws命令即可执行各种操作，例如搜索邮件（gws mail search）、发送邮件（gws mail send）、上传文件（gws drive upload）、导出文件（gws drive export）、管理日历事件（gws calendar list）、管理用户（gws admin users list）等。支持链式操作和脚本化，可集成到自动化工作流中。此外，该工具支持将Workspace操作暴露为MCP（Model Context Protocol）工具，方便AI Agent调用。
适合谁：运维工程师需要批量管理公司Workspace账号和资源；智能体开发者希望将Google Workspace能力集成到AI Agent中；全栈开发者在终端中快速处理邮件、文档和日历数据；数据分析师需要从Gmail/Drive中提取数据进行分析。
使用建议：使用前需配置Google API凭据（OAuth 2.0或服务账号），建议在测试环境先验证API权限。注意该工具不适用于管理Google Cloud基础设施（需使用gcloud）或本地macOS邮件/日历应用。当遇到API调用失败时，可优先使用gws的重试和错误处理机制。
核心特点
专为处理Google API调用失败（403、invalid_grant、配额错误等）场景设计，并可一键将Workspace操作暴露为MCP工具，兼具排障和集成能力。
注意事项
不适用于Google Cloud基础设施（gcloud）管理或本地macOS邮件/日历应用。
常见问题
gws CLI需要哪些Google API权限？
需要启用对应的Google Workspace API（如Gmail API、Drive API等），并配置OAuth 2.0客户端ID或服务账号密钥。
如何解决API调用返回403错误？
gws CLI会自动处理常见权限错误，若仍出现403，请检查API是否已启用、OAuth范围是否完整，或确认服务账号是否有足够权限。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-4/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-4/raw/index.md（查看排版版本）