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-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在终端里用gws搜索上个月所有包含“项目报告”附件的邮件，并把结果导出到CSV文件。’，它会指导你安装gws CLI，配置OAuth凭据，并生成相应的命令行指令，例如 `gws gmail search 'has:attachment 项目报告 newer_than:30d' --format csv > reports.csv`，从而自动化完成邮件搜索和导出任务。
介绍
Google Workspace CLI（gws）是一个终端命令行工具，旨在解决开发者和IT管理员在自动化处理 Google Workspace 服务时遇到的常见痛点。当您需要通过脚本批量操作Gmail邮件、管理Drive文件、处理Calendar日程或使用Admin SDK管理用户和群组时，直接调用Google API可能会遇到403权限错误、invalid_grant认证问题、配额限制或返回空结果等复杂情况，gws CLI通过封装和简化这些API调用流程，让终端操作变得可靠且高效。
使用gws CLI，您可以直接在终端中执行搜索邮件、发送批量邮件、上传/导出/共享文件、管理日历事件以及执行用户管理任务等操作。它支持超过20个Google API，并特别优化了错误处理和重试逻辑，降低了因临时性API错误导致任务失败的风险。此外，它还能将Workspace操作暴露为MCP工具，方便集成到更广泛的自动化工作流中。
这个工具非常适合需要频繁与Google Workspace服务交互的后端开发者、运维工程师和系统管理员。无论是编写自动化脚本处理日常办公任务，还是构建需要集成Gmail、Drive等服务的应用原型，gws CLI都能提供稳定、可编程的接口。对于需要批量处理数据或管理大量用户的企业IT人员来说，它也是一个强大的生产力工具。
使用建议是，在开始前请确保已正确配置Google Cloud项目并启用相关API，获取必要的OAuth 2.0凭据。注意，此工具专注于Google Workspace（如Gmail, Drive, Calendar）的应用层自动化，而非Google Cloud Platform（GCP）的基础设施管理（那是gcloud的领域），也不适用于本地的macOS邮件或日历应用程序。
核心特点
与同类工具相比，gws CLI的核心优势在于其专门针对Google Workspace API调用中常见的403、invalid_grant、配额错误和空结果等问题进行了封装和优化，提供了更稳定的命令行交互体验；同时，它能够将Workspace操作作为MCP工具暴露，便于集成到智能体或自动化流程中，而不仅仅是简单的API调用封装。
注意事项
不适用于管理Google Cloud基础设施（应使用gcloud）或操作本地的macOS邮件和日历应用程序。
常见问题
gws和gcloud有什么区别？
gws用于自动化Google Workspace应用服务（如Gmail, Drive），而gcloud用于管理Google Cloud Platform基础设施（如虚拟机、存储桶）。
gws能用来批量发送邮件吗？
可以，gws CLI支持通过Gmail API批量搜索和发送邮件，是其主要功能之一。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-2/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-2/raw/index.md（查看排版版本）