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-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用gws帮我搜索Gmail中最近一周来自客户的未读邮件，并导出为CSV文件放到我的Google Drive“客户反馈”文件夹中。' 它会自动执行 `gws mail search --query 'from:customer after:2025/01/01 is:unread' --format csv` 和 `gws drive upload --file results.csv --folder '客户反馈'`，完成邮件搜索与文件上传。
介绍
Google Workspace CLI (gws) 是一个命令行工具，用于从终端自动化管理 Google Workspace 的 20 多个 API，包括 Gmail、Drive、Calendar、Sheets、Docs 和 Admin SDK。它解决的核心问题是：当需要通过脚本或 CI/CD 管道批量处理邮件搜索与发送、文件分享与导出、日历事件管理、用户和群组管理等操作时，手动调用 API 或使用 Web 界面低效且易出错。该工具可直接在终端中执行 gws 命令，完成搜索、发送、上传、导出、分享和管理等任务，也可作为 MCP 工具暴露 Workspace 操作，供 AI Agent 调用。
使用方式非常简单：安装后，通过命令行指定动作和参数，例如 gws mail search --query 'from:boss after:2024/01/01' 即可批量搜索邮件。它支持 OAuth 2.0 认证，可配置多个账号，并针对常见错误（如 403、invalid_grant、quota 错误）提供了友好的错误提示和重试机制。对于需要批量处理大量数据的场景，gws 还支持分页和并发控制。
适合运维工程师、全栈开发者和智能体开发者，尤其是那些需要管理 Google Workspace 企业账号、自动化日常办公流程、或构建 AI 助手来操作 Workspace 的用户。例如，IT 管理员可以用它批量创建用户、设置权限；后端开发者可以用它集成邮件和文件功能到自己的应用；AI 智能体开发者可以将其作为 MCP 工具，让 AI 直接操作 Workspace。
使用建议：首次使用前需在 Google Cloud Console 中启用相关 API 并生成 OAuth 客户端凭证。注意，该工具不适用于管理 Google Cloud 基础设施（那是 gcloud 的职责），也不适用于本地 macOS 邮件或日历应用。对于高频调用，建议留意 API 配额限制，并可结合环境变量配置默认账号。
核心特点
与同类 Workspace 管理工具相比，gws 以终端命令行原生方式运行，无需额外服务，且可直接作为 MCP 工具被 AI Agent 调用，实现 Workspace 操作的端到端自动化。
注意事项
不适合用于 Google Cloud 基础设施管理（需使用 gcloud）或本地 macOS 邮件/日历应用的操作。
常见问题
如何配置 Google Workspace API 认证？
需要在 Google Cloud Console 中启用所需 API（如 Gmail API、Drive API），创建 OAuth 2.0 客户端 ID，并下载凭证文件，然后通过 `gws auth login` 命令进行认证。
gws 支持批量操作吗？
支持。例如 `gws mail send --csv recipients.csv` 可批量发送邮件，`gws drive export --folder 'reports' --format pdf` 可批量导出文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-6/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-6/raw/index.md（查看排版版本）