구글, AI 에이전트 지원하는 오픈소스 워크스페이스 CLI 공개

gws는 구글 워크스페이스 팀이 공개한 오픈소스 통합 CLI 도구다. 지메일, 드라이브, 캘린더, 문서, 스프레드시트, 챗 등 워크스페이스 전반의 API를 단일 터미널 명령어로 묶어냈으며, 일반 개발자와 AI 에이전트 모두 손쉽게 다룰 수 있도록 설계되었다.

무엇을 할 수 있나

개발자가 복잡한 REST API 문서를 보며 curl 명령어를 직접 작성할 필요가 없다. 모든 리소스에 대한 도움말 플래그와 사전 검증용 드라이런 기능을 제공하며, 긴 데이터 목록도 NDJSON 형태로 자동 페이지네이션 처리해 출력한다.

자주 쓰는 작업을 위해 더하기 기호가 붙은 전용 헬퍼 명령어들도 갖췄다. 읽지 않은 메일을 빠르게 요약하는 gws gmail +triage, 계정 타임존에 맞춰 일정을 확인하는 gws calendar +agenda, 당일 회의와 업무를 정리하는 gws workflow +standup-report 등을 터미널에서 즉시 실행할 수 있다.

AI 에이전트 환경과의 결합도 매끄럽다. 모든 응답이 구조화된 JSON 규격으로 반환되며, 리포지토리에는 40여 개 이상의 에이전트 스킬 정의가 포함되어 있다. OpenClaw나 제미나이 CLI 확장 기능과 연동하면 별도 도구 개발 없이도 거대언어모델이 워크스페이스 작업을 직접 수행한다.

보안 문제에 대한 대비도 마련되어 있다. 구글 클라우드 모델 아머와 연동해 API 응답 데이터가 AI 모델의 컨텍스트 창으로 넘어가기 전 프롬프트 인젝션 공격 여부를 사전에 걸러낼 수 있다.

작동 방식과 에이전트 연동

gws는 정적인 명령어 목록을 하드코딩하지 않는다. 실행 시점에 구글 디스커버리 서비스를 동적으로 읽어와 명령어 체계를 실시간으로 구성하므로, 워크스페이스에 새로운 API 엔드포인트가 추가되어도 도구 수정 없이 즉시 반영된다.

인증 방식 역시 로컬 개발 환경부터 CI 파이프라인, 헤드리스 서버까지 폭넓게 지원한다. 운영체제 키링 기반의 AES-256-GCM 암호화 저장을 지원하며, 서비스 계정 파일이나 환경 변수를 통한 접근 토큰 전달도 가능하다.

다만 인증 설정 시 주의할 점이 있다. 구글 클라우드의 OAuth 앱이 테스트 모드인 상태에서는 권한 동의 범위가 약 25개로 제한된다. gws의 기본 권장 프리셋은 85개 이상의 범위를 요구하기 때문에, 개인 지메일 계정 등으로 테스트할 때는 드라이브나 지메일 등 필요한 서비스만 명시적으로 지정해 로그인해야 오류를 피할 수 있다.

설치 방법과 주의사항

설치는 깃허브 릴리스의 사전 빌드 바이너리를 직접 내려받거나 npm, 홈브루, 닉스, 카고를 통해 간편하게 진행할 수 있다. 구동을 위해서는 Node.js 18 이상 환경 또는 실행 바이너리와 함께 OAuth 설정이 완료된 구글 클라우드 프로젝트가 필요하다.

공식 문서에서는 이 프로젝트가 구글의 공식 지원 제품이 아니며, 현재 활발히 개발 중인 단계라 1.0 버전에 도달하기 전까지 주요 변경 사항이 발생할 수 있다고 밝히고 있다.

왜 중요한가

AI 에이전트에게 업무용 소프트웨어를 연동해 주는 작업은 늘 번거로운 API 래핑과 유지보수를 수반했다. gws는 런타임 디스커버리 분석과 구조화된 JSON 출력을 통해 이 연동 장벽을 터미널 명령어 수준으로 낮췄다는 점에서 영리한 접근으로 평가할 수 있다.

개인 업무 자동화나 에이전트 기반 프로토타입을 구축하려는 개발자라면 지금 당장 시험해 볼 가치가 충분하다. 다만 아직 1.0 이전의 실험적 도구인 데다 인증 설정상의 제약이 존재하는 만큼, 기업의 핵심 프로덕션 환경보다는 개인 실험과 보조 자동화 도구로 먼저 활용해 보는 편이 안전하다.