gws：Google Workspace命令行工具，一个CLI管理所有Google服务

如果你经常需要管理Google Workspace的各项服务——Gmail、Google Drive、日历、表格、文档——通常需要在浏览器里来回切换。今天介绍一个开源项目gws，用一个命令行工具搞定所有这些操作。

项目介绍

gws是Google Workspace官方CLI工具，可以在一个终端里操作Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin等所有Google Workspace API。最大的亮点是它并非写死一堆固定命令，而是通过读取Google官方的Discovery Service动态生成命令——也就是说，Google只要新增了API端点，gws就能自动支持，不需要等待版本更新。项目由Google团队开发，目前在GitHub已获得超过24000颗星。

特色功能

1. 动态命令生成：gws没有写死的命令列表，而是从Google Discovery API实时获取可用方法，每次运行都会自动发现新功能。

2. 全面的服务覆盖：覆盖Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin等所有主要Google Workspace服务。

3. 结构化JSON输出：所有命令返回结构化的JSON数据，方便脚本处理和二次开发。

4. AI Agent技能支持：内置40多个面向AI Agent的技能模块，让AI可以更方便地调用Google服务。

5. 跨平台支持：提供预编译二进制（Linux、macOS、Windows），也支持通过npm、Homebrew安装。

安装步骤

方式一，使用npm安装（需要Node.js 18+）：

npm install -g @googleworkspace/cli

方式二，使用Homebrew（macOS/Linux）：

brew install googleworkspace-cli

方式三，直接下载GitHub releases中的二进制文件，解压后将gws放到$PATH中即可。

方式四，从源码编译（需要Rust工具链）：

cargo install –git https://github.com/googleworkspace/cli –locked

安装完成后，首先需要配置OAuth凭证：gws auth setup

然后登录Google账号：gws auth login

使用方法

查看Drive文件列表：gws drive files list –params ‘{“pageSize”: 5}’

发送Gmail邮件：gws gmail messages send

查看日历事件：gws calendar events list –calendarId primary

创建Google文档：gws docs documents create –title “我的文档”

所有命令都支持通过 –params 参数传入任意Google API参数，真正做到无限制地调用任何Google API功能。

适用场景

• 自动化办公：将Google Workspace操作集成到Shell脚本或CI/CD流程

• AI Agent集成：让AI助手可以操作Google服务，实现智能化办公自动化

• 批量数据处理：通过命令行批量处理Google表格中的数据

• 系统集成开发：基于Google API开发应用时的调试和测试工具

• 日程管理自动化：配合cron实现自动日程提醒和会议管理

开源协议

gws采用Apache-2.0开源协议，由Google官方团队开发和维护。

服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。