일하는 ai

⌨️ 01. googleworkspace/cli 실무 가이드

7 min read

-

Google Workspace 자동화를 진짜 업무에 붙이려면, API 문서를 보며 curl을 계속 치는 방식으로는 오래 버티기 어렵다. gws는 이걸 “사람과 에이전트가 같이 쓰는 공용 조작판”으로 바꿔 준다.

쉽게 비유하면, 원래 방식이 각 부서 문을 하나씩 열쇠로 따고 들어가야 하는 건물이라면, gws는 출입증 하나로 드라이브·지메일·캘린더·시트를 드나드는 통합 안내데스크에 가깝다.

flowchart LR
A[요청
예: 오늘 메일 요약] --> B[gws CLI]
B --> C[Gmail API]
B --> D[Drive API]
B --> E[Calendar API]
C --> F[구조화 JSON 결과]
D --> F
E --> F
F --> G[에이전트 자동화/리포트/알림]

🧠 칠판 치트시트

  • gws는 Google Workspace API를 CLI로 통합해 주는 도구다.
  • 사람이 쓰기 쉽고(헬프/드라이런), 에이전트가 쓰기 좋다(JSON 출력).
  • 반복 업무(메일 분류, 파일 정리, 일정 동기화)에 특히 강하다.
  • 핵심은 “한 번 잘 실행”이 아니라 “매일 같은 품질로 반복 실행”이다.

앞뒤 흐름 먼저 잡기

CLI·Hook·Skill·MCP의 차이와 작동 방식은 00편에서 먼저 정리해 두었습니다.

이 01편은 그 위에서 Google Workspace CLI(gws)를 실무에 어떻게 붙이는지에 집중합니다.

언제 필요할까

다음 상황이면 거의 무조건 가치가 있다.

  • 매일 Gmail/Drive/Calendar를 오가며 같은 작업을 반복할 때
  • 팀 보고를 위해 데이터를 수집·정리하는 시간이 길 때
  • 에이전트(OpenClaw/Claude Code/MCP 클라이언트)에서 Workspace를 직접 다루고 싶을 때

예를 들어 “오늘 온 교육 요청 메일만 추려서 시트에 정리” 같은 업무는 사람이 하면 2040분이지만, gws 기반으로 파이프라인을 만들면 35분 안으로 줄일 수 있다.

왜 필요한가

1) API 장벽을 낮춰 준다

공식 API는 강력하지만 진입장벽이 있다. gws는 이걸 명령형 인터페이스로 바꿔 준다.

2) 에이전트 친화적이다

응답이 구조화 JSON이라 에이전트가 후처리하기 쉽다. 사람이 읽는 로그보다, 기계가 읽는 결과가 자동화에서는 더 중요하다.

3) Discovery 기반이라 확장성이 좋다

README 기준으로 gws는 Google Discovery Service를 런타임에 읽어 커맨드 표면을 구성한다. 서비스가 늘어도 구조를 계속 유지하기 좋다.

어떻게 쓰고, 어떻게 활용하나

시작 3단계

  1. 설치
npm install -g @googleworkspace/cli
  1. 인증
gws auth setup
gws auth login -s drive,gmail,calendar,sheets
  1. 첫 호출
gws drive files list --params '{"pageSize": 5}'

실무 활용 패턴

  • 메일 운영: 조건 검색 → 우선순위 분류 → 리포트 생성
  • 드라이브 운영: 폴더별 파일 목록 점검 → 중복/오래된 파일 식별
  • 캘린더 운영: 일정 추출 → 브리핑 메시지 생성
  • 시트 운영: 수집 결과를 표 형태로 누적

뭐에 좋은가 (실무 효과)

  • 반복 업무 시간 절감
  • 사람이 놓치기 쉬운 조건 검색 자동화
  • 팀 공유 포맷 통일(JSON → 테이블/리포트)
  • 에이전트 운영에서 “도구 연결” 표준화

미니 사례:

  • Before: 오전마다 메일함/캘린더/드라이브를 수동 점검
  • After: gws 명령 묶음 + 에이전트 스케줄링으로 자동 점검
  • 결과: 같은 품질의 브리핑을 매일 같은 시간에 제공

앞으로 어떻게 쓰이게 될까

단순 CLI를 넘어, gws mcp 같은 경로로 MCP 도구화되면 에이전트 생태계에서 역할이 더 커진다.

쉽게 말해, 앞으로는 “사람이 직접 클릭해서 처리”보다 “에이전트가 Workspace를 표준 도구처럼 호출”하는 흐름이 일반화될 가능성이 높다.

20분 도입 루틴

  • 5분: 매일 반복하는 Workspace 작업 1개를 고른다.
  • 5분: 해당 작업을 조회 → 정리 → 공유 3단계로 나눈다.
  • 5분: gws 명령 2~3개로 최소 루프를 만든다.
  • 5분: 결과를 시트/메시지 중 한 곳으로 자동 전달해 본다.

다음 읽기

AI 활용 고지: 이 문서는 공개 README/공식 문서를 바탕으로 생성형 AI로 초안을 작성하고, 실무 적용 관점으로 재구성했습니다.

그래프 뷰

백링크