[JS/TS] 一行命令搞定Google全家桶，终端里的AI助理上岗了

你是否厌倦了每天在 Gmail 里手动标记邮件、在 Drive 里翻找大文件、在 Calendar 中来回协调会议时间？这些看似微小却频繁消耗精力的任务，现在有了全新的解决方案：一行命令就能搞定。

Google 近日在 GitHub 上正式开源了 Google Workspace CLI（命令行界面），并附带 50 多个开箱即用的预置自动化技能。这并非概念演示，而是你今天就能安装使用的生产级工具。只需通过 npm 安装一个包，一个 AI Agent 就能接管并自动化你的整个 Google Workspace 工作流。

1. 动态生成命令，告别静态列表

与大多数功能固定的 CLI 工具不同，Google Workspace CLI 的核心机制是其动态性。它会在运行时读取 Google Discovery Service，实时构建出完整的命令树。这意味着，只要 Google Workspace 增加了新的 API，这个 CLI 就能自动支持，你无需等待工具更新版本。

看看它是如何工作的：

gws drive files list --params '{"pageSize": 5}'
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 预算"}}'

每个命令都附有详尽的 --help 说明，你还可以使用 gws schema 来查询任何方法的数据结构。繁琐的文档翻阅工作，就此省去。

2. 结构化 JSON 输出，AI 的天然语言

该 CLI 工具使用 Rust 编写，其所有输出均为结构化的 JSON 格式。这不仅对人类友好，更是为 AI Agent 量身定制。

gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

使用 --page-all 参数可以自动处理 API 分页，并将结果以 NDJSON 流的形式输出。AI Agent 可以直接调用这些命令并解析返回的 JSON，无需再编写额外的解析逻辑，极大简化了集成步骤。

3. 内置 50+ 自动化技能，即刻提效

项目仓库直接提供了超过 50 个预置的“技能”（Skills），这些是即装即用的真自动化，而非演示。安装仅需一行命令：

npx skills add https://github.com/googleworkspace/cli

安装完成后，你就可以用自然语言对你的 AI 助手发出指令：

• “把所有来自客户的邮件标记为 ‘client’ 并归档”
• “找出我的 Drive 里占用空间最大的 20 个文件”
• “为我和客户在下周找一个双方都有空的 1 小时会议时段”
• “导出本月所有主题包含 ‘invoice’ 的邮件”

AI 将理解并直接执行这些命令，整个过程无需你编写任何代码。

4. 这些技能具体能做什么？

Gmail 自动化 (13项技能)

• 自动标记和归档邮件：所有客户邮件自动打上“client”标签并移出收件箱，保持收件箱清爽。
• 批量发送个性化邮件：读取 Google Sheets 中的联系人列表，为每个人生成并发送定制化的开场白，无需邮件合并工具。
• 自动保存附件到 Drive：将邮件中的附件（如合同PDF）自动保存到预设的 Drive 文件夹，并按发件人分类整理。
• 批量回复邮件：对多封需要相同回复的邮件（例如“感谢您的来信”）执行一键批量回复。

Drive 管理 (11项技能)

• 审计外部共享：定期运行，快速列出所有被公开分享或共享给外部邮箱的文件，完成安全审计。
• 查找大文件：当 Drive 空间不足时，快速定位占用空间最大的文件，方便清理决策。
• 批量重命名文件：将大量文件（例如 image_001.png）按照新规则（如 campaign-march-001.png）统一重命名。
• 转移文件所有权：在员工离职时，将其持有的所有文件所有权批量转移给继任者或经理，简化 IT 管理流程。

Calendar 自动化 (8项技能)

• 自动屏蔽专注时间：在工作日历中自动设置重复的“专注时间”事件，保护不受干扰的深度工作时段。
• 智能查找空档：根据自然语言描述（如“下周找个1小时空档”），自动检查多方日历并返回可行的会议时间建议。
• 灵活改期并通知：直接要求“将周二的客户会议改到周四下午3点”，AI 会移动会议事件并自动邮件通知所有参与者。
• 从 Sheets 批量创建日程：读取 Sheets 中规划好的内容日历，自动为每一行创建对应的 Calendar 事件。

5. 原生支持 MCP，与 Claude 等 AI 无缝集成

Model Context Protocol (MCP) 是由 Anthropic 推动的、用于标准化 AI 与外部工具交互的协议。Google Workspace CLI 直接内置了 MCP Server。

只需在你的 AI 工具配置文件中添加几行：

{
  “mcpServers”： {
    “google-workspace”： {
      “command”: “gws”,
      “args”: [“mcp”],
      “env”: {}
    }
  }
}

配置完成后，像 Claude 这样的 AI 助手 就能直接读取你的邮件、创建文档、查询日程，实现全自动化操作。

6. 从复杂编码到一行命令的演进

在过去，若想让 AI Agent 操作 Google Workspace，你需要经历一个复杂的过程：

1. 深入研究庞杂的 REST API 文档。
2. 自行处理繁琐的 OAuth 2.0 认证流程。
3. 编写 HTTP 请求和响应解析代码。
4. 处理 API 分页、错误重试等边界情况。
5. 将结果转换为 AI 能理解的格式。

而现在，这一切被简化为：一行命令，返回 JSON，AI 直接使用。结合 MCP 协议和预置技能库，AI Agent 的能力边界被大幅扩展：

• 自动整理收件箱，为重要邮件打标归档。
• 读取 Sheets 数据，生成分析报告并写入 Docs。
• 解析邮件内容，自动创建对应的 Calendar 事件。
• 监控 Drive 文件的变动，并触发后续工作流程。

你的整个 Google Workspace，由此变成了一个高度可编程的接口。

7. 一个重要注意事项：OAuth 范围限制

目前存在一个需要留意的技术细节。如果你的 Google Cloud OAuth 应用仍处于“测试模式”（未经 Google 验证），Google 会限制最多只能授权 25 个 OAuth 范围 (Scopes)。

而 Google Workspace CLI 的推荐预设包含了 85 个以上的 Scopes，这会导致授权直接失败。

解决方案有两种：

1. 登录时仅选择所需服务：在初次授权时，通过参数明确指定范围。

   gws auth login -s drive,gmail,sheets

2. 提交应用验证：前往 Google Cloud Console 提交 OAuth 应用验证申请。但这通常需要数天的审核时间。

结语

我们每天手动处理的那些琐事——标记邮件、挪动会议、查找文件、发送通知——单看起来都是小事。但日积月累，它们悄无声息地吞噬着我们每周数小时的宝贵时间。

AI Agent + 功能强大的 CLI，目的正是将这些重复性工作交还给机器。 Google 此次开源 Workspace CLI，相当于已经铺好了自动化高速公路。剩下的问题很简单：你准备好踩下油门，拥抱更高效的工作方式了吗？欢迎在云栈社区分享你的使用体验和自动化技巧。