googleworkspace/cli

大卫队

一个CLI覆盖整个Google Workspace——为人类和AI代理打造。 Drive、Gmail、日历和所有工作区API。零模板。结构化JSON输出。包含40+座席技能。

[!注] 这不是官方支持的谷歌产品。

⬇️ 下载最新版本以配合你的操作系统

gws 不提供静态命令列表。它在运行时读取 Google 自己的 Discovery Service，并动态构建整个命令表面。当 Google Workspace 添加 API 端点或方法时，gws 会自动接收。

[!重要] 该项目正在积极开发中。随着我们迈向v1.0的推进，请期待重大变更。

目录

• 先决条件
• 安装
• 快速入门
• 为什么是GWS？
• 认证
• 人工智能代理技能
• 高级用法
• 环境变量
• 出口代码
• 建筑学
• 故障排除
• 发展

先修条件

• Node.js 18+ — 用于npm install（或从GitHub Releases下载预构建的二进制文件）
• Google Cloud 项目 — OAuth 凭证的必要条件。您可以通过 Google Cloud 控制台、gcloud CLI 或 gws auth setup 命令创建。

gws

One CLI for all of Google Workspace — built for humans and AI agents. Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.

[!NOTE] This is not an officially supported Google product.

⬇️ Download the latest release for your OS

gws doesn’t ship a static list of commands. It reads Google’s own Discovery Service at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, gws picks it up automatically.

[!IMPORTANT] This project is under active development. Expect breaking changes as we march toward v1.0.

Contents

• Prerequisites
• Installation
• Quick Start
• Why gws?
• Authentication
• AI Agent Skills
• Advanced Usage
• Environment Variables
• Exit Codes
• Architecture
• Troubleshooting
• Development

Prerequisites

• Node.js 18+ — for npm install (or download a pre-built binary from GitHub Releases)
• A Google Cloud project — required for OAuth credentials. You can create one via the Google Cloud Console or with the gcloud CLI or with the gws auth setup command.
• A Google account with access to Google Workspace

Installation

The recommended way to install gws is to download the pre-built binary for your OS and architecture from the GitHub Releases page. Extract the archive and place the gws binary in your $PATH.

For convenience, you can also use npm to automate downloading the appropriate binary from GitHub Releases:

npm install -g @googleworkspace/cli

Or build from source:

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

A Nix flake is also available at github:googleworkspace/cli