googleworkspace/cli

GWS

구글 워크스페이스 전체를 위한 하나의 CLI — 인간과 AI 에이전트를 위해 구축됨.
Drive, Gmail, 캘린더, 그리고 모든 Workspace API를 지원합니다. 보일러플레이트는 전혀 없습니다. 구조화된 JSON 출력. 40+ 에이전트 기술 포함.

[! 참고] 이 제품은 공식적으로 지원되는 구글 제품이 아닙니다.

⬇️ 운영체제용 최신 릴리스를 다운로드하세요

gws는 정적인 명령 목록을 제공하지 않습니다. 런타임에 구글의 자체 디스커버리 서비스를 읽고 전체 명령 표면을 동적으로 구축합니다. 구글 워크스페이스가 API 엔드포인트나 메서드를 추가할 때, gws가 자동으로 이를 선택합니다.

[! 중요] 이 프로젝트는 현재 활발히 개발 중입니다. v1.0으로 나아가면서 획기적인 변화가 발생할 수 있습니다.

목차

• 선수 조건
• 설치
• 퀵 스타트
• 왜 GWS야?
• 인증
• AI 에이전트 기술
• 고급 사용
• 환경 변수
• 출구 코드
• 건축
• 문제 해결
• 개발

선수 조건

• Node.js 18+ — npm install에 대해(또는 GitHub Releases에서 미리 구축된 바이너리 다운로드 가능)
• Google Cloud 프로젝트 — OAuth 자격 증명에 필요합니다. Google Cloud Console을 통해 생성하거나 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