CLI quản lý toàn bộ Google Workspace

TL;DR

Công cụ dòng lệnh giúp bạn điều khiển tất cả Google Workspace (Drive, Gmail, Calendar, Sheets…) qua terminal. Đặc biệt hỗ trợ AI agent — mỗi response trả về JSON có cấu trúc, sẵn sàng cho agent xử lý tiếp. Không cần viết code gọi API, cài xong là chạy được.

Nói đơn giản: Gõ lệnh trong terminal để quản lý file Drive, gửi email, tạo lịch — không cần mở trình duyệt, AI agent cũng làm được.

Bài này dành cho ai?

1. Người muốn tự động hóa công việc với Google Workspace

Vấn đề: Mỗi ngày phải làm thủ công những việc lặp đi lặp lại với Drive, Gmail, Calendar — tốn thời gian, dễ quên

Khi nào cần: Gửi report hàng ngày qua Gmail, backup file Drive, tạo lịch họp, kiểm tra email quan trọng

Được gì: Gõ 1 dòng lệnh thay vì thao tác thủ công 10-15 phút mỗi ngày

2. Người muốn build AI agent quản lý workspace

Vấn đề: AI agent cần gọi Google Workspace API nhưng viết code gọi REST API rồi parse response rất mệt

Khi nào cần: Build agent tự đọc email, tạo file, quản lý lịch — mà không muốn tự viết SDK

Được gì: Agent gọi gws drive files list là có JSON sẵn sàng xử lý, không phải viết code parse gì cả

3. Dev muốn script hóa thao tác Google Workspace

Vấn đề: Muốn tự động hóa nhưng không muốn dùng Google Apps Script hay viết code SDK nặng nề

Khi nào cần: CI/CD pipeline cần upload file, cron job backup data, bash script xử lý email

Được gì: Tool nhẹ, gọn, không phụ thuộc vào thư viện nặng, output JSON dễ parse

Các điểm chính

1. Commands được tạo tự động từ Google API thực tế

Tool này không có danh sách commands cố định. Nó đọc Discovery Service của Google — cái Google dùng để mô tả API của họ — rồi build commands tự động. Khi Google thêm API mới, gws tự cập nhật theo.

→ Làm gì: Chạy gws schema drive.files.list để xem cấu trúc request/response của bất kỳ method nào.

2. AI agent đọc được kết quả ngay

Mọi output đều là structured JSON. Không phải text parse lỗi tè le, không phải regex gì cả. Agent nhận JSON là xử lý được liền.

→ Làm gì: Khi build AI agent, cứ gọi gws command rồi parse JSON — không cần viết wrapper gì.

3. MCP Server — AI client nào cũng dùng được

gws có thể chạy như MCP server, expose Google Workspace API thành tools. Claude Desktop, Gemini CLI, VS Code đều gọi được.

→ Làm gì: Thêm config vào MCP client:

`{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }`
  }
}

4. 100+ agent skills có sẵn

Repo có sẵn SKILL.md cho từng API (Gmail, Drive, Sheets, Calendar…) và 50 recipes cho workflow thường dùng. Agent chỉ việc gọi skill.

→ Làm gì: Cài skill bằng npx skills add https://github.com/googleworkspace/cli

5. Nhiều cách đăng nhập — laptop, server, CI đều được

Hỗ trợ: đăng nhập tương tác (browser), headless/CI (export credentials), service account (server-to-server), access token có sẵn.

→ Làm gì: Server không có browser? Chạy gws auth export --unmasked rồi copy credentials qua.

6. Dry-run trước khi chạy thật

Mọi lệnh đều có --dry-run để xem request sẽ gửi gì trước khi thực thi. An toàn khi chưa quen.

→ Làm gì: Thêm --dry-run vào lệnh bất kỳ để preview.

Quick Start

1. Cài đặt và xác thực — trong tuần này

npm install -g @googleworkspace/cli

# Cài xong chạy setup, tự tạo GCP project và đăng nhập
gws auth setup

2. Thử vài lệnh cơ bản

# Liệt kê 5 file gần nhất trong Drive
gws drive files list --params '`{"pageSize": 5}`'

# Tạo spreadsheet mới
gws sheets spreadsheets create --json '`{"properties": {"title": "Báo cáo tháng"}`}'

# Gửi tin nhắn Chat
gws chat spaces messages create \
  --params '`{"parent": "spaces/xyz"}`' \
  --json '`{"text": "Deploy xong rồi nhen."}`'

3. Nếu muốn dùng với AI agent

# Start MCP server cho drive, gmail, calendar
gws mcp -s drive,gmail,calendar