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-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在终端里用gws搜索上个月所有包含“项目报告”附件的邮件，并把结果导出到CSV文件。’，它会指导你运行类似 `gws gmail search "has:attachment 项目报告 after:2024-03-01" --export csv` 的命令来完成。或者，当你说‘我需要批量给市场部的所有成员分享一个Drive文件夹的编辑权限’，AI会建议使用 `gws drive share <folder_id> --role writer --group marketing@company.com` 命令来实现。
介绍
Google Workspace CLI（gws）是一个命令行工具，旨在解决开发者和IT管理员在终端中自动化操作 Google Workspace 服务的需求。它封装了超过20个Google API，让你无需编写复杂的脚本或处理繁琐的OAuth流程，就能直接通过命令行搜索邮件、管理云端硬盘文件、操作日历事件、管理用户和群组等。
使用时，你只需安装gws CLI并进行授权配置，即可在终端中使用直观的命令执行各种操作，例如批量搜索和发送Gmail邮件、上传或导出Google Drive文件、管理Google Calendar事件，或通过Admin SDK进行用户和群组管理。它特别适合处理那些在直接调用Google API时可能遇到的403权限错误、无效授权（invalid_grant）、配额错误或空结果等问题。
该工具非常适合需要频繁与Google Workspace服务交互的后端开发、运维工程师、系统管理员以及需要自动化办公流程的团队。对于需要将Google Workspace操作暴露为MCP（Model Context Protocol）工具，以集成到更广泛的AI或自动化工作流中的开发者来说，它也极具价值。
需要注意的是，gws CLI专注于Google Workspace的生产力套件（如Gmail, Drive, Calendar, Sheets, Docs）和管理功能，并不适用于管理Google Cloud基础设施（那是gcloud CLI的领域），也不适用于本地的macOS邮件或日历应用程序。在使用前，请确保你拥有相应Google Workspace域的管理员权限或足够的API访问权限。
核心特点
与通用的Google Cloud CLI（gcloud）不同，gws CLI专注于Google Workspace的生产力套件和管理API，提供了更贴近办公自动化场景的、开箱即用的命令，简化了处理API认证错误和配额问题的流程。
注意事项
不适用于管理Google Cloud基础设施（如Compute Engine, Cloud Storage）或操作本地macOS邮件和日历应用。
常见问题
gws 和 gcloud 有什么区别？
gcloud 用于管理 Google Cloud 基础设施（如虚拟机、存储桶），而 gws 专门用于自动化 Google Workspace 应用（如 Gmail、Drive、Calendar）和管理用户。
gws 能处理 Google API 的错误吗？
是的，它特别设计用于处理常见的 API 错误，如 403 权限错误、invalid_grant 和配额问题，并提供更友好的重试或替代方案。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-5/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-5/raw/index.md（查看排版版本）