최근 Google Workspace CLI, 즉 gws가 공개되며 Gmail·Drive·Calendar·Sheets 같은 구글 앱을 터미널에서 다루는 길이 열렸습니다.12 겉으로는 "브라우저 대신 명령어로 더 빨리 일하는 도구"처럼 보이지만, 지금 중요한 이유는 속도보다도 구글 업무를 반복 가능한 명령으로 바꿔 사람과 AI가 함께 쓸 수 있게 만들기 때문입니다.23
이 관점이 중요합니다. 같은 일을 브라우저 클릭으로 하면 개인의 손놀림에 남고, Apps Script로 하면 특정 작성자의 코드에 갇히기 쉽습니다. 반면 CLI는 "누가 해도 같은 결과가 나는 작업 단위"를 만들 수 있습니다. 도입 여부는 기능 수보다, 당신의 Google 업무를 어디에 살게 할지의 결정에 가깝습니다.
브라우저, Apps Script, CLI 중 무엇이 맞나
세 방식은 경쟁 관계라기보다 계층이 다릅니다.
브라우저는 일회성 작업에 가장 낫습니다. 메일 한 통 확인하고, 파일 하나 공유하고, 회의 하나 잡는 일이라면 굳이 터미널을 열 이유가 없습니다. 학습 비용이 없고, 시각적으로 확인도 쉽습니다.
Apps Script는 "구글 안에서 도는 작은 앱"에 가깝습니다. 시트 이벤트에 반응하거나 문서/시트 중심 자동화를 만들 때 강합니다. 대신 인증, 유지보수, 실행 환경이 스크립트에 묶이고, Gmail·Drive·Calendar를 가로지르는 범용 운영 인터페이스로 쓰기엔 다소 불균형합니다.
gws는 그 중간이 아니라 다른 층입니다. Google Discovery Service를 읽어 런타임에 명령을 동적으로 구성하고, 결과를 구조화된 JSON으로 반환합니다.2 즉 "Google Workspace API를 사람도 치고, 쉘 스크립트도 돌리고, AI 에이전트도 호출할 수 있는 공용 명령 계층"에 가깝습니다. 반복 작업이 많고, 결과를 jq나 파이프라인으로 넘기거나, 팀원이 같은 작업을 재현해야 할 때 가치가 커집니다.
실무 기준으로 간단히 말하면 이렇습니다.
한 번만 하는 일은 브라우저, 구글 내부 이벤트에 붙는 작은 자동화는 Apps Script, 여러 서비스에 걸친 반복 작업과 재사용 가능한 운영 절차는 CLI가 맞습니다.
진짜 포인트는 인간과 AI가 공유하는 명령 언어다
공식 저장소는 gws를 "humans and AI agents"를 위한 도구로 소개합니다.2 이 표현은 마케팅 문구라기보다 설계 방향을 보여줍니다. 모든 응답이 JSON이고, 메서드 스키마를 조회하는 기능이 있으며, 에이전트 스킬도 포함됩니다.24
이게 왜 중요할까요. 지금까지 AI가 Google Workspace를 만지려면 보통 두 가지 우회가 필요했습니다. 브라우저 자동화에 의존하거나, 서비스별 API 래퍼를 따로 만들어 붙이는 방식입니다. 전자는 깨지기 쉽고, 후자는 팀마다 다른 도구가 생깁니다.
CLI는 그 사이에서 꽤 안정적인 계약면을 제공합니다. 예를 들어 "최근 Drive 파일 10개 조회", "특정 조건의 Gmail 검색", "캘린더 이벤트 생성"이 명령으로 정리되면, 사람이 터미널에서 검증한 작업을 AI 에이전트도 거의 같은 형태로 재사용할 수 있습니다. 속도보다 중요한 건 가시성과 이식성입니다. 누가 어떤 권한으로 무슨 작업을 했는지, 적어도 브라우저 클릭보다 훨씬 명확해집니다.
다만 여기엔 단서가 있습니다. gws는 구글 공식 지원 제품이 아니며, 아직 v1.0 이전이라 브레이킹 체인지 가능성이 명시돼 있습니다.2 그래서 "팀의 핵심 업무 시스템"보다는 내부 운영 자동화, 개인 생산성, 에이전트 실험에 먼저 쓰는 편이 현실적입니다.
처음 시험해볼 만한 건 세 가지면 충분하다
기능이 많다고 처음부터 넓게 들어가면 실패합니다. 작은 자동화 하나로 유용성을 검증하는 편이 낫습니다.
첫째, Gmail 분류나 요약입니다. 읽지 않은 메일 목록을 JSON으로 뽑아 필터링하고, 필요한 메일만 후속 처리하는 흐름은 CLI의 장점이 잘 드러납니다. 메일 본문 전체 자동 처리까지 바로 가기보다, "검색 → 목록화 → 사람이 확인" 단계부터 시작하는 게 안전합니다.
둘째, Drive 보고 작업입니다. 최근 수정 파일, 특정 이름 패턴, 특정 폴더의 파일 목록을 추출해 주간 보고나 백업 점검에 쓰기 좋습니다. 브라우저에서 가장 귀찮은 반복 검색을 명령으로 고정하기 좋기 때문입니다.
셋째, Calendar와 다른 앱을 잇는 흐름입니다. 예를 들어 메일에서 일정 정보를 확인한 뒤 캘린더에 초안 이벤트를 만들거나, 회의 목록을 뽑아 시트로 보내는 식입니다. 단일 앱 자동화보다 "앱 사이 연결"에서 CLI의 존재 이유가 분명해집니다.
이때 꼭 써볼 옵션이 --dry-run입니다. 실제 호출 전에 요청 내용을 확인할 수 있어, 특히 메일 발송이나 데이터 수정처럼 되돌리기 어려운 작업에서 중요합니다.2
기대를 낮춰야 오히려 잘 쓴다
실망할 지점도 분명합니다.
첫째, 설정이 가볍지 않습니다. OAuth용 Google Cloud 프로젝트가 필요하고, gcloud가 없으면 수동 설정을 해야 합니다.2 특히 테스트 모드의 미검증 앱은 동의 가능한 스코프 수가 제한돼, 권장 스코프 전체를 한 번에 쓰기 어려울 수 있습니다.2
둘째, 모든 업무를 터미널로 옮길 필요는 없습니다. 문서를 읽으며 판단하는 일, 드래그 앤 드롭이 더 빠른 일, 시각적 확인이 중요한 협업은 브라우저가 낫습니다. CLI는 반복 가능하고 규칙화되는 작업에서만 빛납니다.
셋째, "구글 앱용 Zapier 대체재"라는 기대도 절반만 맞습니다. Google 안에서 끝나는 흐름에는 강하지만, Slack·Salesforce·HubSpot처럼 외부 SaaS까지 묶는 오케스트레이션은 별도 도구가 여전히 필요합니다.5
결국 판단 기준은 단순합니다. 클릭 몇 번을 줄이느냐가 아니라, 자주 반복되는 Google 업무를 팀의 공용 명령으로 만들 가치가 있느냐입니다. 그 가치가 있는 팀이라면 gws는 꽤 매력적입니다. 반대로 업무가 대부분 일회성이고 시각적 확인이 중요하다면, 터미널은 생산성 도구가 아니라 불필요한 우회일 수 있습니다.
지금 신경 써야 할 사람은 두 부류입니다. Google Workspace를 많이 쓰는 운영·관리 실무자, 그리고 AI 에이전트가 실제 업무를 건드리게 만들고 싶은 팀입니다. 이들에게 gws는 "터미널에서 구글 앱 쓰기" 이상의 의미가 있습니다. 브라우저 클릭, 임시 스크립트, AI 에이전트 호출 사이에 공통 인터페이스를 하나 세우는 선택지이기 때문입니다. 시작은 작게 하세요. 메일 분류든, Drive 리포트든, 캘린더 초안 생성이든 한 가지 반복 업무만 명령으로 바꿔보면 도입 가치가 금방 드러납니다.
참고
3Google releases Workspace CLI to lower barriers to AI agent integration
4Google Workspace CLI: Gmail, Drive 등을 위한 AI 우선 명령줄 도구
5Google Workspace CLI: Automate Gmail, Drive & Calendar From Your Terminal
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.