Google Workspace CLI
Google Workspace (googleworkspace GitHub organization) · 코딩
Google Workspace CLI는 대부분 사람들이 gws라고 부르는 무료 오픈소스 명령줄 도구로, Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin을 하나의 인터페이스 뒤에 묶어 웹 UI를 다시는 건드리지 않게 해준다. REST 문서를 보며 curl 호출을 손으로 쓰는 대신 명령을 하나 실행하면 구조화된 JSON이 돌아온다. 이 도구는 두 부류의 사용자를 동시에 겨냥한다. Workspace를 빠르게 스크립트로 다루려는 개발자, 그리고 기계가 읽을 수 있는 출력과 완성된 스킬이 필요한 AI 에이전트다. 이 이분법이 많은 설계를 설명해준다.
Google Workspace CLI 소개
Google Workspace CLI란
Google Workspace CLI는 GitHub의 googleworkspace 조직이 만든 Rust 기반 도구로, 모든 Google Workspace API를 하나의 바이너리에 담는다. 영리한 점은 고정된 명령 목록을 넣지 않는다는 것이다. 실행 시점에 Google의 Discovery Service를 읽고 명령 체계를 즉석에서 구성한다. 그래서 Google이 API 엔드포인트를 추가하면 gws는 업데이트 없이 그것을 가져온다. 출력은 기본적으로 구조화된 JSON이라, 스크립트나 LLM에게도, 터미널 앞에 앉은 사람에게도 똑같이 쓸모 있다.
이 프로젝트가 노리는 대상은 하루 종일 Workspace 안에서 살면서 웹 UI 클릭질을 그만두고 싶은 사람들, 그리고 AI 어시스턴트를 일상 업무 도구에 연결하는 개발자층이다. OAuth로 한 번 인증하면 하나의 셸에서 파일을 나열하고, 스프레드시트를 만들고, Chat 메시지를 보내고, 캘린더 일정을 가져온다. 약 40개의 AI 에이전트 스킬도 함께 제공하므로 어시스턴트는 별도 도구 없이 Workspace 작업을 처리할 수 있다. 접착 코드가 필요 없다.
중요한 단서가 하나 있다. 이것은 Google이 공식 지원하는 제품이 아니다. 활발히 개발 중이며, 관리자들은 v1.0에 이르는 길에 호환성을 깨는 변경을 예상해야 한다고 경고한다. 신경 써야 할까. 스크립트에 장기적 안정성이 필요하다면 그렇다. 라이선스는 Apache-2.0이고, OAuth 자격 증명을 위해 자신의 Google Cloud 프로젝트가 필요하다. 잘 다듬어지고 안정성을 보장받는 도구를 원한다면 이건 아니다. 모든 Workspace API에 닿는 빠르게 움직이는 도구를 원한다면 이만한 게 드물다. 절충은 각자 고르면 된다.
시작하기
- Node.js 18 이상을 설치하거나, GitHub Releases 페이지에서 자신의 운영체제용 사전 빌드 바이너리를 받는다.
npm install -g @googleworkspace/cli로 gws를 설치하거나, macOS에서는 Homebrew를 쓴다.gws auth setup을 실행해 Google Cloud 프로젝트 설정과 OAuth 자격 증명 과정을 차례로 진행한다.- Workspace 접근 권한이 있는 Google 계정으로
gws auth login을 통해 로그인한다. - 최근 Drive 파일 10개를 나열하는 등 실제 명령을 시험해보고 JSON 응답을 확인한다.
제품 정보
Google Workspace CLI의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- Workspace 작업을 스크립트로 다루는 개발자
- AI 에이전트 개발자
- 시스템 관리자와 IT 담당자
작업
- Drive 파일 작업 자동화
- Sheets에서 보고서 생성
- 스크립트에서 Chat이나 Gmail 메시지 전송
활용 상황
- Workspace를 CI/CD 파이프라인에 연결
- 요청에 따라 회의를 잡거나 문서를 정리하는 개인 비서 구축.
- 여러 계정과 공유 드라이브에 걸친 워크스페이스 대량 관리.
주요 기능
Discovery Service에서 실시간으로 구성되는 명령 체계
이 CLI는 명령을 하드코딩하지 않는다. 실행 시점에 Google의 Discovery Service를 읽어, 모든 Workspace API 엔드포인트와 메서드가 자동으로 명령이 된다. Google이 새 엔드포인트를 내놓으면 gws 릴리스를 기다리지 않고 바로 쓴다. 정적 래퍼가 못 하는 방식으로 도구를 최신으로 유지하는 지점이 바로 여기다. 아주 단순한 이야기다.
에이전트를 위한 구조화 JSON 출력
모든 응답은 구조화 JSON으로 돌아온다. 사람에게는 jq나 스크립트로 넘길 수 있는 예측 가능하고 파싱하기 쉬운 출력을 뜻한다. AI 에이전트에게는 LLM이 접착 코드 없이 Workspace 데이터를 읽고 행동할 수 있다는 뜻이다. 이 도구가 일반인만큼 에이전트 개발자에게도 팔리는 핵심 이유다. 출력은 깨끗하게 유지된다.
함께 제공되는 AI 에이전트 스킬
약 40개의 에이전트 스킬이 프로젝트에 딸려 오며 일반적인 Workspace 워크플로를 아우른다. 도구 정의를 처음부터 작성하는 대신 이것들을 에이전트에 넣고 Drive, Gmail, Calendar 작업을 맡길 수 있다. "LLM이 있다"에서 "내 LLM이 내 Workspace를 관리한다"로 가는 길을 줄여준다. 큰 지름길이다.
내장 도움말, 시험 실행, 자동 페이지 처리
모든 리소스가 --help를 지원하므로 터미널을 떠나지 않고 명령을 살펴볼 수 있다. --dry-run 플래그는 요청을 보내기 전에 미리 보여줘, 낯선 엔드포인트를 익힐 때 편하다. 자동 페이지 처리가 큰 결과 집합을 담당하므로 수백 개의 Drive 파일이나 Gmail 메시지를 한 묶음씩 넘기는 반복문을 짤 필요가 없다.
모든 Workspace 서비스를 아우르는 단일 인터페이스
Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin이 모두 같은 명령 구조 뒤에 있다. 패턴을 한 번 익히면 어디든 적용하므로, 별도 SDK를 번갈아 쓰며 생기는 맥락 전환이 줄어든다. 로그인 한 번으로 전체를 커버한다. 요점이 여기 있다.
크로스 플랫폼 설치 옵션
gws는 npm, Homebrew, Cargo, Nix 플레이크로 설치하거나, 자신의 운영체제용 사전 빌드 바이너리를 받아도 된다. 이 유연성 덕분에 Mac 노트북이든 Linux 서버든 Windows 머신이든 대부분의 개발 환경에 들어맞는다.
장단점
장점
- Apache-2.0으로 무료이며 오픈소스다. 걱정할 유료 등급이 없다.
- 일관된 단일 인터페이스로 모든 Google Workspace API를 아우른다.
- 실시간 Discovery Service 연동이 명령 집합을 최신으로 유지해 Google Workspace 자동화를 유지보수하기 쉽게 만든다.
- JSON 출력과 함께 제공되는 에이전트 스킬이 AI 에이전트 워크플로에서 진짜로 유용하다.
- 여러 설치 경로(npm, Homebrew, Cargo, Nix, 사전 빌드 바이너리)가 거의 모든 환경에 맞는다.
단점
- Google 공식 지원 제품이 아니라 공식적인 Google 지원 약속이 없다.
- v1.0 전에 호환성을 깨는 변경이 예상되므로 릴리스 후 스크립트를 갱신해야 할 수 있다.
- 설정에 자신의 Google Cloud 프로젝트와 OAuth 구성이 필요해, 비개발자에게는 실질적인 장벽이다.
자주 묻는 질문
그렇다. Apache-2.0 라이선스의 오픈소스이며 비용이 들지 않는다. Google 계정과 OAuth용 Google Cloud 프로젝트는 필요하지만, 일반적인 개인이나 개발자 용도에서는 둘 다 요금이 붙지 않는다.
관련 콘텐츠
Google Workspace CLI와 관련된 도구, 스킬, 아티클을 살펴보세요.
Google Workspace CLI 대안
Forefront
Forefront · 코딩Forefront는 오픈소스 AI로 무언가를 만드는 웹 플랫폼이다. 대표적인 오픈소스 언어 모델을 자신의 데이터로 미세 조정하고, 성능을 평가하고, API로 실행하거나 내보내 직접 호스팅할 수 있다. 폐쇄형 플랫폼의 편의를 원하면서도 모델과 데이터의 소유권은 놓지 않으려는 개발자가 대상이다.
Startkit
StartKit.AI · 코딩Startkit은 AI SaaS와 AI 래퍼 제품을 만들기 위한 보일러플레이트다. 지루한 부분을 미리 연결해 둔 AI 스타트업 보일러플레이트라고 생각하면 된다. 인증, Stripe와 Lemon Squeezy 결제, 사용량 제한, 트랜잭션 이메일, 그리고 OpenAI, Anthropic, Groq, Llama와 통신하는 AI API 스타터 키트가 포함된다. 저장소를 복제하고 가격을 정한 뒤 사용자가 실제로 돈을 내는 부분에 착수하면 된다. React와 Tailwind 위의 Next.js로 만들어졌기 때문에 보일러플레이트 코드의 상당 부분이 이미 익숙하게 느껴진다.
Testim
Tricentis · 코딩Testim은 웹, 모바일, Salesforce 애플리케이션 전반에 걸쳐 엔드투엔드 테스트를 만들고 실행하는 AI 기반 테스트 자동화 플랫폼이다. 머신러닝에 기대어 인터페이스가 바뀌어도 테스트를 안정적으로 유지하므로, 팀은 깨진 셀렉터를 고치는 데 쓰는 시간을 줄인다. 오늘부터 쓸 수 있는 자동화 테스트 도구치고 나쁘지 않다. 브라우저에서 동작을 녹화해 테스트를 만들고, 더 세밀한 제어가 필요하면 JavaScript를 더한다. 바쁜 QA 팀에게 탄탄한 선택이다.