Google Workspace CLI 完全操作指南：用命令行接管你的整个办公套件

npm install -g @googleworkspace/cli

git clone https://github.com/googleworkspace/cli.git
cd cli
cargo install --path .

gws auth setup

gws auth login

gws auth export --unmasked > credentials.json

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json
gws drive files list   # 直接可用

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
gws drive files list

export GOOGLE_WORKSPACE_CLI_IMPERSONATED_USER=admin@example.com

# 列出最近 10 个文件
gws drive files list --params '{"pageSize": 10}'

# 搜索特定文件
gws drive files list --params '{"q": "name contains '\''报告'\''"}'

# 上传文件
gws drive files create --json '{"name": "report.pdf"}' --upload ./report.pdf

# 流式分页输出所有文件名（NDJSON 格式）
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

# 列出收件箱邮件
gws gmail users messages list --params '{"userId": "me", "maxResults": 10}'

# 读取特定邮件
gws gmail users messages get --params '{"userId": "me", "id": "MESSAGE_ID"}'

# 搜索邮件
gws gmail users messages list --params '{"userId": "me", "q": "from:boss@company.com subject:紧急"}'

# 创建新表格
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 预算"}}'

# 读取表格数据
gws sheets spreadsheets values get \
  --params '{"spreadsheetId": "SHEET_ID", "range": "Sheet1!A1:D10"}'

# 写入数据
gws sheets spreadsheets values update \
  --params '{"spreadsheetId": "SHEET_ID", "range": "Sheet1!A1", "valueInputOption": "RAW"}' \
  --json '{"values": [["姓名", "部门", "金额"], ["张三", "市场部", "5000"]]}'

# 查看今天的日程
gws calendar events list \
  --params '{"calendarId": "primary", "timeMin": "2026-03-05T00:00:00Z", "timeMax": "2026-03-05T23:59:59Z"}'

# 创建会议
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "周报会议",
    "start": {"dateTime": "2026-03-06T14:00:00+08:00"},
    "end": {"dateTime": "2026-03-06T15:00:00+08:00"},
    "attendees": [{"email": "colleague@company.com"}]
  }'

# 创建新文档
gws docs documents create --json '{"title": "项目方案 v2"}'

# 读取文档内容
gws docs documents get --params '{"documentId": "DOC_ID"}'

# 发送消息到聊天空间
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "部署完成 ✅"}'

# 预览请求（不实际发送）
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "测试消息"}' \
  --dry-run

# 查看任意方法的请求/响应 Schema
gws schema drive.files.list

# 预览请求但不实际执行
gws drive files list --params '{"pageSize": 5}' --dry-run

# 自动分页（NDJSON 输出）
gws drive files list --page-all --page-limit 20 --page-delay 200

# 只暴露 Drive
gws mcp -s drive

# 暴露多个服务
gws mcp -s drive,gmail,calendar

# 暴露所有服务（工具数量会很多，注意客户端限制）
gws mcp -s all

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

# 一次安装所有 Skills
npx skills add https://github.com/googleworkspace/cli

# 只安装你需要的
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

# 先完成认证
gws auth setup

# 安装 Gemini CLI 扩展
gemini extensions install https://github.com/googleworkspace/cli

#!/bin/bash
# 每天早上自动汇总未读邮件
UNREAD=$(gws gmail users messages list \
  --params '{"userId":"me","q":"is:unread","maxResults":20}' \
  | jq -r '.messages[].id')

for id in $UNREAD; do
  gws gmail users messages get \
    --params "{\"userId\":\"me\",\"id\":\"$id\"}" \
    | jq '{subject: .payload.headers[] | select(.name=="Subject") | .value, from: .payload.headers[] | select(.name=="From") | .value}'
done

#!/bin/bash
# 从 JSON 文件批量导入会议
cat meetings.json | jq -c '.[]' | while read meeting; do
  gws calendar events insert \
    --params '{"calendarId": "primary"}' \
    --json "$meeting"
done

#!/bin/bash
# 监控指定文件夹的变更
gws drive files list \
  --params "{\"q\": \"'FOLDER_ID' in parents\", \"orderBy\": \"modifiedTime desc\", \"pageSize\": 5}" \
  | jq '.files[] | {name, modifiedTime, id}'

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"