googleworkspace/cli

어떤 프로젝트인가요?

핵심 기능

• 01Google Discovery Service를 바탕으로 명령어를 동적으로 구성하므로 새 API 메서드가 자동으로 추가됩니다.
• 02오류를 포함한 모든 응답을 구조화된 JSON으로 출력합니다.
• 03--dry-run으로 요청을 미리 확인하고, --page-all로 NDJSON 페이지네이션을 처리할 수 있습니다.
• 04AI 에이전트가 사용할 수 있는 Agent Skills 100개 이상과 Gemini CLI 확장을 제공합니다.
• 05대화형 OAuth, 서비스 계정, 액세스 토큰, CI용으로 내보낸 자격 증명 등 다양한 인증 방식을 지원합니다.

활용 사례

• 터미널이나 CI 작업에서 Drive, Sheets, Gmail의 반복 작업을 스크립트로 처리합니다.
• AI 에이전트가 구조화된 명령을 통해 캘린더를 조회하고, 이메일을 보내거나, 스프레드시트를 업데이트하도록 합니다.
• 배포 후 메시지를 게시하는 등 Google Chat 알림을 자동화합니다.
• Workspace 데이터를 jq나 다른 셸 도구에 전달해 보고서를 작성합니다.

빠른 시작

1. 1

   npm으로 CLI 설치

   npm install -g @googleworkspace/cli
2. 2

   Google Cloud 프로젝트 및 OAuth 사용자 인증 정보 설정

   gws auth setup
3. 3

   OAuth로 로그인(이후 로그인)

   gws auth login
4. 4

   Drive에서 가장 최근 파일 5개 나열

   gws drive files list --params '{"pageSize": 5}'

사용 전 알아둘 점

• !Google에서 공식적으로 지원하는 제품이 아닙니다.
• !프로젝트는 활발히 개발 중이며 v1.0 이전에 호환성이 깨지는 변경 사항이 적용될 수 있습니다.
• !테스트 모드의 미확인 앱은 scope가 약 25개로 제한되므로, 권장 scope 프리셋 전체를 사용하면 실패합니다.
• !본인의 Google 계정을 테스트 사용자로 추가해야 합니다. 추가하지 않으면 액세스가 차단되었다는 오류가 발생해 로그인할 수 없습니다.

토픽

자주 묻는 질문

cli은(는) 무엇인가요?

Drive, Gmail, Calendar 등 Google Workspace API를 JSON으로 다루는 CLI gws는 Google Workspace용 커맨드라인 클라이언트입니다. REST 엔드포인트에 직접 curl 호출을 작성하는 대신, gws drive files list나 gws sheets spreadsheets create 같은 명령을 실행하면 됩니다. 명령어 세트는 Google Discovery Service를 바탕으로 런타임에 구성되므로, API 메서드가 새로 추가되면 도구를 업데이트하지 않아도 바로 사용할 수 있습니다. 모든 리소스에서 --help를 지원하고, --dry-run으로 요청을 보내기 전에 미리 확인할 수 있으며, --page-all을 사용하면 페이지로 나뉜 결과를 NDJSON 스트림으로 받을 수 있습니다.

cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

cli은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

cli은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. cli의 마지막 커밋은 2026년 10월 6일입니다.

cli은(는) 어디에 사용할 수 있나요?

터미널이나 CI 작업에서 Drive, Sheets, Gmail의 반복 작업을 스크립트로 처리합니다. AI 에이전트가 구조화된 명령을 통해 캘린더를 조회하고, 이메일을 보내거나, 스프레드시트를 업데이트하도록 합니다. 배포 후 메시지를 게시하는 등 Google Chat 알림을 자동화합니다. Workspace 데이터를 jq나 다른 셸 도구에 전달해 보고서를 작성합니다.

cli는 어떻게 설치하나요?

npm으로 CLI 설치: npm install -g @googleworkspace/cli Google Cloud 프로젝트 및 OAuth 사용자 인증 정보 설정: gws auth setup OAuth로 로그인(이후 로그인): gws auth login Drive에서 가장 최근 파일 5개 나열: gws drive files list --params '{"pageSize": 5}'

cli은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/googleworkspace/cli