구글, 워크스페이스 전용 통합 CLI 도구 'gws' 공개...AI 에이전트 연동 지원

구글 워크스페이스 팀이 모든 워크스페이스 API를 하나로 묶는 오픈소스 CLI를 공개했다.

[한국정보기술신문] 구글 워크스페이스 개발팀이 드라이브, 지메일, 캘린더, 스프레드시트, 문서, 채팅, 어드민 등 워크스페이스 전 서비스를 단일 커맨드라인 인터페이스(CLI)로 제어할 수 있는 오픈소스 도구 'gws'를 깃허브에 공개했다. 해당 저장소는 공개 이후 현재까지 별 5,100개 이상을 기록하며 개발자 커뮤니티의 높은 관심을 받고 있다.

gws란 무엇인가

gws는 구글의 디스커버리 서비스를 런타임에 직접 읽어 전체 명령어 구조를 동적으로 생성하는 방식을 채택했다. 기존 CLI 도구들이 정적인 명령어 목록을 사전 등록해두는 것과 달리, gws는 구글이 새로운 API 엔드포인트나 메서드를 추가하면 도구 업데이트 없이도 자동으로 해당 기능을 인식하고 제공한다. 이로써 개발자는 최신 구글 워크스페이스 기능을 별도의 업데이트 없이 즉시 활용할 수 있다.

설치는 npm 패키지 매니저를 통해 npm install -g @googleworkspace/cli 명령어 한 줄로 가능하며, Rust 소스코드를 직접 빌드하거나 Nix 플레이크 방식으로도 설치할 수 있다. 전체 코드베이스는 Rust로 작성되어 있으며, 저장소 내 Rust 코드 비중은 99.3%에 달한다.

AI 에이전트 연동을 위한 설계

gws의 가장 주목할 만한 특징 중 하나는 AI 에이전트와의 연동을 처음부터 염두에 두고 설계되었다는 점이다. 모든 응답이 구조화된 JSON 형식으로 출력되어 대형 언어 모델(LLM)이 결과를 바로 파싱하고 처리할 수 있다. 또한 저장소에는 드라이브, 지메일, 달력, 스프레드시트 등 주요 서비스에 대한 100개 이상의 에이전트 스킬 파일(SKILL.md)이 함께 제공된다.

모델 컨텍스트 프로토콜(MCP) 서버 기능도 내장되어 있어, 클로드 데스크톱, 제미나이 CLI, VS Code 등 MCP 호환 클라이언트가 구글 워크스페이스 API를 구조화된 도구로 직접 호출할 수 있다. gws mcp -s drive,gmail,calendar 명령어 하나로 원하는 서비스의 MCP 서버를 즉시 실행할 수 있다.

다양한 인증 방식과 보안 설계

gws는 개인 노트북, CI/CD 환경, 서버 등 다양한 환경을 고려한 여러 인증 방식을 지원한다. 일반 사용자는 gws auth setup 명령어로 구글 클라우드 프로젝트 설정과 OAuth 로그인을 단계적으로 진행할 수 있다. 여러 구글 계정을 동시에 등록하고 기본 계정을 지정하거나, 명령어 실행 시 특정 계정으로 일시적으로 전환하는 것도 가능하다.

자격 증명은 AES-256-GCM 방식으로 암호화되어 운영체제의 키링에 저장되며, 헤드리스 CI 환경에서는 사전에 내보낸 자격 증명 파일을 환경 변수로 지정해 사용할 수 있다. 서비스 계정 키를 통한 서버 간 인증과 도메인 전체 위임(Domain-Wide Delegation)도 지원한다.

구글 클라우드 모델 아머(Model Armor)와의 연동 기능도 포함되어 있어, API 응답이 AI 에이전트에 전달되기 전에 프롬프트 인젝션 공격 여부를 자동으로 스캔할 수 있다.

현황 및 향후 전망

gws는 현재 활발히 개발 중인 프로젝트로, 2026년 3월 5일 버전 0.3.5를 릴리즈했다. 개발팀은 v1.0을 향해 진행하는 과정에서 하위 호환성을 보장하지 않는 변경이 있을 수 있음을 공지하고 있다. 오픈소스 라이선스는 아파치 2.0이 적용되며, 구글의 공식 지원 제품은 아니다.

AI 에이전트가 업무 자동화의 핵심 수단으로 자리 잡아가는 흐름 속에서, 이처럼 범용 SaaS 도구를 CLI와 MCP 서버로 통합하는 접근 방식이 기업 환경에서 어떻게 수용될지 귀추가 주목된다.

한국정보기술신문 인공지능분과 이준 기자 news@kitpa.org