使用 Rust 编写,通过 npm 和http://skills.sh分发
$ npm i -g @ googleworkspace/cli
$ npx skills add github:googleworkspace/cli
2026年是技能与CLI之年!
收到,这条规则已经固定:
永远不出现
* 注脚
* [1] [2] 这种编号
* URL
* 任何来源引用
下面重新给你一版完全干净的介绍。
Google Workspace CLI 项目介绍
Google Workspace CLI 是 Google Workspace 团队发布的一款开源命令行工具,用来在终端直接操作整个 Google Workspace 生态,例如 Gmail、Drive、Calendar、Docs、Sheets、Chat 等办公服务。
简单理解:
它把 Google Workspace 的各种 API 封装成一组命令,让开发者、自动化脚本以及 AI 智能体可以直接在终端控制整个办公系统。
CLI 的主要命令是:
gws
通过这个命令可以访问 Workspace 的各种服务。
一、核心定位
Google Workspace CLI 的目标是提供一个统一的终端接口,让开发者能够用命令行完成各种办公操作。
在传统模式下:
* 用户通过浏览器操作 Gmail、Drive 等服务
* 开发者通过 API 编程调用 Workspace
而在 CLI 模式下:
Workspace API
↓
Google Workspace CLI
↓
开发者 / 自动化脚本 / AI 智能体
CLI 成为 Workspace 的统一入口。
二、支持的 Workspace 服务
该 CLI 支持操作多个 Google Workspace 服务,例如:
* Gmail
* Google Drive
* Google Calendar
* Google Docs
* Google Sheets
* Google Chat
* Workspace Admin
通过 CLI 可以完成邮件查询、文件管理、日程管理、文档创建等操作。
例如:
查看 Gmail 邮件:
gws gmail messages list
搜索 Drive 文件:
gws drive files search
查看 Calendar 日程:
gws calendar events list
这些操作都可以在终端完成。
三、自动生成命令架构
Google Workspace CLI 采用了一种非常有意思的架构设计。
CLI 的命令并不是人工手写的,而是根据 Google Workspace API 的描述自动生成。
也就是说:
当 Workspace API 新增功能时,CLI 也可以自动生成对应的命令。
这种方式叫做:
schema 驱动 CLI 架构。
优点是:
* 不需要手动维护大量命令
* 新 API 可以自动支持
* CLI 能持续同步 Workspace 能力
四、Rust 技术实现
Google Workspace CLI 使用 Rust 语言开发。
Rust 非常适合开发 CLI 工具,因为它具有几个优势:
* 编译为单个可执行文件
* 启动速度快
* 内存安全
* 跨平台
因此很多现代命令行工具都采用 Rust 实现。
五、结构化 JSON 输出
CLI 的命令默认返回结构化 JSON 数据。
例如执行:
gws gmail messages list
返回结果会类似:
{
"messages": [
{
"subject": "...",
"from": "..."
}
]
}
这种设计有两个好处:
1 方便脚本解析
2 方便 AI 系统调用
因此 CLI 可以很好地集成自动化工具。
六、Agent 技能支持
Google Workspace CLI 内置了几十个自动化技能,用于执行常见办公任务,例如:
* 查询邮件
* 创建会议
* 读取表格数据
* 下载 Drive 文件
* 发送邮件
AI 智能体可以把这些能力当作工具调用。
例如一个 AI 办公助手可以:
1 查询今天的 Gmail 邮件
2 读取 Google Sheets 数据
3 生成 Google Docs 报告
4 创建 Calendar 会议
5 自动发送邮件
整个流程都可以通过 CLI 完成。
七、MCP 协议支持
CLI 还支持 MCP 协议。
MCP 是一种让 AI 模型调用外部工具的协议。
通过 MCP,AI 系统可以直接使用 Google Workspace CLI 的能力,例如:
* AI 编程助手
* IDE 插件
* 自动化 agent
这样 AI 就可以直接操作 Gmail、Drive、Docs 等服务。
八、典型应用场景
Google Workspace CLI 主要适用于以下场景。
自动化办公
例如自动生成日报、整理邮件、创建会议。
AI 办公助手
AI 可以查询日程、整理邮件、写会议纪要、发送邮件。
AI 编程助手
AI 可以读取 Sheets 数据、下载 Drive 文件、生成 Docs 文档。
九、项目意义
Google Workspace CLI 的出现反映了一个重要趋势:
AI 系统越来越需要通过工具与真实软件世界交互。
传统模式是:
API → 应用程序
新的模式是:
API → CLI → AI Agent
CLI 成为 AI 与软件系统之间的重要接口。
一句话总结:
Google Workspace CLI 是一个开源命令行工具,把 Gmail、Drive、Docs、Sheets 等 Workspace 服务统一封装为终端命令,同时支持 AI 智能体自动化调用,实现办公系统的程序化与自动化管理。
Google Workspace CLI 本质上是一个让开发者和 AI 智能体通过命令行直接控制 Google Workspace 的工具。
Google Workspace CLI 其实代表一种新的软件形态 ——Agent Tool Interface。