Google Workspace CLI
终端自动化管理Google Workspace的CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Google Workspace CLI。 它的用途是：终端自动化管理Google Workspace的CLI工具 完整的 Skill 内容见：https://321skill.com/skills/google-workspace-cli-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用gws CLI搜索Gmail中最近7天来自某客户的邮件，并导出为CSV文件'，它会自动调用gws命令完成搜索和导出，无需手动操作网页。或者：'将本地~/docs文件夹同步到Google Drive根目录，并设置所有团队成员可查看'，gws会递归上传并设置共享权限，适合团队协作场景。
介绍
Google Workspace CLI（gws）是一个开源的命令行工具，让您直接从终端高效管理Google Workspace的各项服务。它封装了Gmail、Drive、Calendar、Sheets、Docs及Admin SDK等20多个Google API，解决日常运维中常见的API调用失败问题（如403权限错误、invalid_grant令牌失效、配额超限、空结果等），并支持批量操作，例如批量搜索和发送邮件、批量上传导出文件、管理用户和群组、共享和导出文件等。
使用方式非常简洁：安装后通过gws命令即可执行各类操作，无需在多个网页控制台间切换。例如，您可以用它搜索特定条件的邮件并导出为CSV，将本地文件夹同步至Drive并设置共享权限，或批量创建日历事件。此外，gws还可以作为MCP工具暴露给AI助手，让智能体直接调用Google Workspace能力，实现自动化工作流。
适合运维工程师、全栈开发者和智能体开发者，尤其是需要频繁管理Google Workspace企业账号、批量处理邮件或文件、以及希望将Workspace操作集成到自动化脚本或AI Agent中的用户。对于需要快速排查API错误或批量执行管理任务的团队，gws能显著提升效率。
使用前需注意：gws专注于Google Workspace的管理，不适合用于Google Cloud基础设施（如GCE、GKE等）或本地的macOS邮件日历应用。首次使用需完成OAuth授权，建议提前在Google Cloud Console中启用相关API并配置凭据。另外，注意遵守API配额限制，避免触发限流。
核心特点
相比Google Workspace官方网页控制台或零散API脚本，gws提供统一的CLI接口，可一键处理API常见错误（403、invalid_grant、quota errors），并原生支持作为MCP工具集成到AI工作流中，实现智能体直接调用Workspace功能。
注意事项
不适用于Google Cloud基础设施（gcloud）或本地macOS邮件日历应用的管理。
常见问题
如何安装gws CLI？
推荐使用npm全局安装：npm install -g @googleworkspace/gws，也可从GitHub Releases下载二进制文件。
首次使用需要哪些授权？
需在Google Cloud Console中创建项目并启用相关API，然后通过gws auth login命令完成OAuth授权。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-7/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-7/raw/index.md（查看排版版本）