🔧 Công cụ lập trình•Mã nguồn mở•
Google Workspace CLI
CLI chính thức từ Google cho toàn bộ Workspace API, tự sinh lệnh từ Discovery Service, viết bằng Rust, hỗ trợ batch và pipe.
#google-workspace-cli
Danh mục
🔧 Công cụ lập trình
Giá
Mã nguồn mở
GitHub Stars
⭐ 31,234
Ngôn ngữ
Rust
License
Apache-2.0
Ngày thêm
2026-03-28
Tóm tắt từ README GitHub
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.
This is not an officially supported Google product.
⬇️ Download the latest release for your OS
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, picks it up automatically.
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 (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 CLI or with the command.
- A Google account with access to Google Workspace
Installation
The recommended way to install is to download the pre-built binary for your O
Xem thêm từ README.mdThu gọn README.md
Đánh giá chi tiết
Tổng quan
Google Workspace CLI là công cụ dòng lệnh chính thức từ Google cho toàn bộ Workspace API: Gmail, Calendar, Drive, Sheets, Docs, Admin, và nhiều hơn. CLI tự sinh lệnh từ Google Discovery Service, nghĩa là khi Google thêm API mới, CLI tự động hỗ trợ. Repo có hơn 22,800 stars, viết bằng Rust.
Tính năng chính
- Phủ toàn bộ Google Workspace API: Gmail, Calendar, Drive, Sheets, Docs, Meet, Admin, Groups
- Auto-generated commands từ Discovery Service: API mới tự có lệnh
- Batch operations: xử lý hàng loạt (tạo 100 events, xóa 50 emails)
- Pipe support: kết hợp với jq, grep, awk cho data processing
- OAuth2 authentication: login 1 lần, token tự refresh
- Output: JSON, CSV, table format
Stack kỹ thuật
- Rust, single binary
- Google OAuth2 + Discovery Service API
- Generated từ API schema, không viết tay
Điểm mạnh
- Phủ 100% Google Workspace API, bao gồm cả Admin SDK
- Tự cập nhật theo Discovery Service, không bao giờ outdated
- Rust binary nhanh, không cần runtime
- Pipe-friendly, kết hợp tốt với Unix tools
Hạn chế
- CLI phức tạp do phủ quá nhiều API, learning curve cao
- Cần tạo OAuth2 credentials trong Google Cloud Console
- Một số API (Admin) yêu cầu domain-wide delegation
- Documentation tự sinh, đôi khi thiếu ví dụ thực tế
Phù hợp khi nào
Admin/developer cần tự động hóa Google Workspace: batch operations trên Gmail, Drive, Calendar, hoặc build script quản lý organization.