Google Workspace CLI (gws)는 Google이 2026년 3월 공개한 커맨드라인 도구로, Gmail, Google Drive, Calendar, Sheets, Docs, Chat, Admin Console 등 Google Workspace 서비스를 하나의 CLI로 관리할 수 있습니다. Rust로 작성되었으며, AI 에이전트 통합을 핵심 설계 목표로 합니다.
gws drive, gws gmail, gws sheets, gws docs, gws calendar, gws chat, gws admin 등 하위 명령어로 각 서비스 조작
Google Discovery Service에서 API 스키마를 동적 빌드 → 새 API 추가 시 CLI 자동 확장
100개+ 빌트인 스킬 (사람 + AI 에이전트 모두 사용)
git 스타일 워크플로우
gws sheets pull <spreadsheet-id> # Google Sheet → 로컬 .tsv + formula.json
# 로컬에서 편집 (에이전트가 .tsv 수정)
gws sheets push # 변경사항 → Google Sheet에 반영
Sheets → .tsv + formula.json으로 분해
Docs → 로컬 파일로 변환
에이전트 친화적 포맷으로 자동 변환
AI 에이전트 통합
MCP (Model Context Protocol) 지원 → Claude Desktop, VS Code, Gemini CLI 등에서 연동
raw JSON 페이로드를 API 스키마에 직접 매핑
런타임에 최신 스키마 정보 출력 → AI가 외부 문서 검색 불필요 (토큰 절약)
입력 검증: 잘못된 경로, 제어 문자 등 차단 (AI 환각 방지)
인증
방식
설명
GOOGLE_WORKSPACE_CLI_TOKEN
환경변수에 access token 직접 설정
Application Default Credentials (ADC)
gcloud auth 연동
authorized_user
개인 사용자 인증
service_account
서비스 계정 (자동화/CI용)
사용 예시
# Drive 파일 목록gws drive files list# Gmail 검색gws gmail messages list --query "from:boss@company.com is:unread"# Calendar 이벤트 조회gws calendar events list --calendar-id primary# Sheets 내용을 로컬로 가져와서 편집 후 푸시gws sheets pull 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms# edit locally...gws sheets push# Admin 사용자 목록gws admin users list
대안: gogcli (OpenClaw)
항목
gws (Google 공식)
gogcli
개발
Google
Peter Steinberger (OpenClaw)
언어
Rust
Go
라이선스
Apache 2.0
MIT
범위
Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin
Gmail, Calendar, Drive, Docs, Contacts, Tasks, Forms, Apps Script, Classroom