구글 워크스페이스 CLI: “API 있으면 된다”가 에이전트 자동화 날리는 이유

구글 워크스페이스 CLI(gws)가 2026년 3월 첫째 주 GitHub에 조용히 등장했습니다. 그런데 이것, 단순한 개발자 도구가 아닙니다. Gmail·Drive·Calendar·Sheets를 터미널 한 줄로 제어하고, AI 에이전트가 직접 업무를 실행할 수 있는 새로운 인터페이스입니다. “API 문서 보고 curl 치면 되지”라고 생각하신다면, 이미 경쟁자들한테 뒤처지고 있을 가능성이 높습니다.

구글 워크스페이스 CLI(gws)가 뭔가요? — 3줄 요약

구글 워크스페이스 CLI, 줄여서 gws는 Google이 2026년 3월 5일 GitHub에 공개한 오픈소스 커맨드라인 도구입니다. 한마디로 정리하면 “인간과 AI 에이전트 모두를 위해 만들어진, Google Workspace 전체를 단 하나의 CLI로 제어하는 도구”입니다. Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin 등 거의 모든 Workspace API를 단일 인터페이스로 통합합니다.

특히 눈길을 끄는 점은 명령어가 정적으로 내장된 것이 아니라는 사실입니다. gws는 런타임에 Google의 Discovery Service에서 API 스키마를 가져와 명령 구조를 동적으로 생성합니다. 즉, Google이 새 API 엔드포인트를 추가하는 순간, 업데이트 없이도 gws에서 바로 쓸 수 있습니다. 이 설계 방식은 장기간 자율 작동하는 AI 에이전트에게 결정적인 장점으로 작용합니다.

그럼에도 공개 직후 GitHub 스타가 수천 개에 달할 정도로 개발자 커뮤니티에서 폭발적인 반응을 얻고 있습니다. AI 에이전트가 이메일을 보내고, 스프레드시트를 수정하고, 캘린더를 관리하는 시대의 핵심 인프라가 될 가능성이 높기 때문입니다.

▲ 목차로 돌아가기

기존 API 방식과 무엇이 다른가 — 왜 지금 주목받나

“Google Workspace API 쓰면 되지, 뭐가 새로워?” 이렇게 생각하실 수 있습니다. 그런데 기존 방식에는 결정적인 불편함이 있었습니다. Gmail API, Drive API, Calendar API 등 서비스마다 인증 체계가 다르고, 각각의 REST 문서를 따로 읽어야 하고, JSON 요청을 직접 구성해야 했습니다. AI 에이전트 입장에서는 더 심각했는데, 이메일을 확인하고 → Drive에서 관련 파일을 찾고 → 캘린더 일정을 잡는 단순한 워크플로 하나를 처리하려면 서로 다른 API 세 개를 조합해야 했습니다.

제 개인적인 시각으로는 이게 단순한 편의 도구 이상의 의미를 가집니다. gws는 AI 에이전트가 Google Workspace를 ‘직접 제어할 수 있는 언어’를 처음으로 제공한 것입니다. 인간이 버튼을 클릭하지 않아도 에이전트가 스스로 이메일을 보내고, 파일을 정리하고, 회의를 잡을 수 있는 인프라가 완성된 것이죠. CLI의 부활이 아니라, 에이전트 시대의 새로운 표준 인터페이스가 탄생한 것입니다.

▲ 목차로 돌아가기

설치부터 인증까지 — 10분 안에 시작하는 법

① 사전 준비

gws를 사용하려면 Node.js 18 이상이 필요합니다. 또한 Google Cloud 프로젝트와 OAuth 자격 증명이 반드시 필요합니다. Google 계정만 있으면 무료로 Cloud 프로젝트를 생성할 수 있으니 걱정하지 않아도 됩니다. gcloud CLI가 설치되어 있다면 가장 빠른 경로로 진행할 수 있습니다.

② 설치 (3가지 방법)

# 방법 1: npm으로 설치 (가장 간단)
npm install -g @googleworkspace/cli
# 방법 2: macOS/Linux Homebrew
brew install googleworkspace-cli
# 방법 3: Rust 소스 빌드
cargo install --git https://github.com/googleworkspace/cli --locked

③ 인증 설정 — gcloud 있는 경우 (가장 빠름)

# 한 번만 실행 — Google Cloud 프로젝트 자동 생성 + API 활성화
gws auth setup
# 이후 로그인은 이 명령으로
gws auth login

④ gcloud 없는 경우 — 수동 OAuth 설정

Google Cloud Console에서 직접 설정하는 방법입니다. 아래 순서를 따르세요.

1. Google Cloud Console에서 새 프로젝트 생성
2. OAuth 동의 화면 설정 (앱 유형: External → 테스트 모드)
3. 테스트 사용자에 본인 이메일 추가 (이걸 빠뜨리면 “Access blocked” 오류 발생)
4. 사용할 API(Gmail, Drive 등) 활성화
5. OAuth 클라이언트 생성 (유형: Desktop app)
6. JSON 다운로드 → ~/.config/gws/client_secret.json 저장
7. gws auth login 실행

▲ 목차로 돌아가기

핵심 명령어 실전 치트시트 — Gmail·Drive·Sheets·Calendar

gws의 가장 강력한 기능 중 하나는 헬퍼 명령어(Helper Commands)입니다. 접두사 +가 붙은 이 명령들은 복잡한 API 파라미터 없이 자연스러운 방식으로 일상적인 업무를 처리해 줍니다. 아래는 바로 복사해서 사용할 수 있는 핵심 명령어 모음입니다.

📧 Gmail — 이메일 자동화

# 읽지 않은 이메일 요약 (수신함 트리아지)
gws gmail +triage
# 이메일 보내기
gws gmail +send --to alice@example.com --subject "안녕하세요" --body "내용"
# 메시지에 답장 (스레딩 자동 처리)
gws gmail +reply --message-id MESSAGE_ID --body "감사합니다!"
# 새 이메일 실시간 스트리밍 감시
gws gmail +watch

📁 Drive — 파일 관리

# 최근 파일 10개 목록 조회
gws drive files list --params '{"pageSize": 10}'
# 파일 업로드 (메타데이터 자동 설정)
gws drive +upload ./report.pdf --name "2026 Q1 보고서"
# 멀티파트 업로드
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'

📊 Sheets — 스프레드시트 자동화

# 새 스프레드시트 생성
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 예산"}}'
# 셀 범위 읽기 (주의: ! 는 반드시 단따옴표로 감싸야 함)
gws sheets spreadsheets values get \
--params '{"spreadsheetId": "ID", "range": "Sheet1!A1:C10"}'
# 행 추가 (헬퍼 명령어로 간단하게)
gws sheets +append --spreadsheet SPREADSHEET_ID --values "홍길동,95"

📅 Calendar + Workflow — 스마트 업무 도우미

# 오늘 일정 확인 (계정 타임존 자동 적용)
gws calendar +agenda
# 다음 회의 준비: 안건·참석자·링크 문서 자동 요약
gws workflow +meeting-prep
# 스탠드업 리포트 생성 (오늘 회의 + 미완료 작업 요약)
gws workflow +standup-report
# 이메일을 Google Tasks로 변환
gws workflow +email-to-task

▲ 목차로 돌아가기

AI 에이전트와 연결하기 — MCP·OpenClaw·Gemini CLI

gws의 진짜 힘은 AI 에이전트 프레임워크와 연결될 때 발휘됩니다. 세 가지 주요 연동 방식을 살펴보겠습니다.

① MCP(Model Context Protocol) 서버로 활용

gws는 Anthropic이 개발한 Model Context Protocol(MCP)의 서버로 동작할 수 있습니다. MCP를 지원하는 모든 AI 클라이언트(Claude, Cursor, Windsurf 등)에서 gws를 통해 Google Workspace에 직접 접근할 수 있게 됩니다. 특정 모델이나 프레임워크에 종속되지 않는 범용성이 핵심입니다.

② OpenClaw(오픈클로) 연동

gws 공식 문서에서 OpenClaw를 명시적으로 지원합니다. 오스트리아 개발자 Peter Steinberger가 2025년 말 시작한 이 오픈소스 AI 에이전트 플랫폼은 2026년 초 빠르게 성장했고, Steinberger는 이후 OpenAI에 합류했습니다. gws 스킬을 OpenClaw에 연동하는 방법은 아래와 같습니다.

# 모든 gws 스킬을 OpenClaw에 심볼릭 링크로 연동
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/
# 특정 스킬만 선택해서 복사
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

③ Gemini CLI 확장으로 설치

구글 자체 에이전트 환경인 Gemini CLI에도 gws를 확장으로 직접 설치할 수 있습니다. 설치하면 Gemini CLI 에이전트가 모든 gws 명령과 Workspace 에이전트 스킬에 직접 접근할 수 있습니다. 인증도 gws에서 처리하므로 별도 설정이 필요 없습니다.

# 1단계: gws 인증 먼저 완료
gws auth setup
# 2단계: Gemini CLI에 gws 확장 설치

# 모든 스킬 한 번에 설치
npx skills add https://github.com/googleworkspace/cli
# Drive 스킬만 선택 설치
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
# Gmail 스킬만 선택 설치
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail