• 로그인
  • 장바구니에 상품이 없습니다.

구글 Workspace CLI 사용해서 AI에게 일시키기



요즘은 AI agent를 써서 일도 하고 연애도하고 모든걸 다 하려고 하는데

심지어 오픈클로한테 아이디 비번까지 알려주는 사람들도 있습니다.

그래서 기업들도 이제는 사람이 아니라 AI가 쓸 수 있는 프로그램을 개발하기 시작했습니다.

AI가 쓰는 프로그램들이 뭐 있냐면 대표적으로 MCP, Skills가 있습니다.

예를 들어 Line MCP를 만들어두면 AI가 Line 메세지를 마음대로 전송이 가능해지는 식입니다.





더 나아가서 요즘은 AI가 쓸 수 있는 CLI 프로그램을 만들기 시작했습니다.

CLI 프로그램은 까만 터미널 창에서 명령어 입력으로 동작하는 프로그램을 말합니다.

MCP, Skills 같은거 달랑 만들어놓는거 보다는 CLI로 만드는게 장점이 몇개가 있는데


- MCP 잘 모르는 AI가 아직도 있음

- 근데 터미널 명령어 입력은 다들 잘함

- 토큰 많이 안잡아먹어서 효율적임

- API key같은 정보들을 AI가 직접 다루지 않아서 유출 위험이 적음

이런 장점이 있어서 AI용 CLI 프로그램을 만들어서 배포하는 기업들이 점점 보이기 시작합니다.







그래서 최근에 구글 직원들이 만든 Google Workspace CLI 라는 프로그램이 나왔는데

이걸 설치해두면 터미널에서 구글드라이브, Gmail, Google Meet 등 모든 업무용 프로그램 사용이 가능합니다.

예를 들어 gmail.com까지 안가도 그냥 터미널 켜서 gws gmail 이런 명령어 입력하면 이메일 출력이 가능해집니다.

그럼 gws 명령어 이걸 AI agent에게 알려주면 AI에게 업무를 대신 시켜볼 수도 있게 되는 겁니다.

"인간과 AI 모두를 위한 CLI" 라고 지칭하고 있긴 한데

명령어가 너무 복잡하고 계속 바뀌어서 AI에 넣어서 쓰는게 좋긴 합니다.






Google Workspace CLI 설치는


1. 구글에 Node.js 검색해서 설치합니다.

2. 구글에 구글 클라우드 CLI 검색해서 설치합니다.

윈도우는 인스톨러 같은게 있고 맥은 설치 스크립트 파일을 줍니다.

3. 검색메뉴에서 powershell 혹은 터미널을 검색해서 실행하면 까만 창이 뜨는데

npm install -g @googleworkspace/cli
gws auth setup

이런 명령어 2개를 차례로 입력해봅시다. 그럼 CLI 프로그램 설치가 되고 셋팅을 시작해줍니다.






셋팅은


그냥 터미널에서 시키는거 그대로 하면 됩니다. 체크마크는 스페이스바, 다음페이지는 엔터키입니다.


1. gws auth setup 입력하면 일단 구글계정으로 로그인하라고 하는데 로그인하고


2. 구글 클라우드 프로젝트 하나 선택하라고 하는데 새로 하나 만들어도 됩니다.



3. 터미널에서 다루고 싶은 구글 제품들 선택해줍니다.



4. OAuth 하나 만들어와서 그 Client ID와 Client Secret 키를 각각 붙여넣으라고 합니다.

터미널에 뜨는 링크 컨트롤 클릭해서 들어가서 OAuth 앱을 아무 이름으로 하나 만들면 됩니다.

- 사진에 있는 파란색 글자에서 시키는거 그대로 따라서 만들면 됩니다.

- 그럼 Client ID, Client Secret을 발급받아올 수 있는데 복사해와서 각각 붙여넣어주면 끝입니다.

- 그리고 OAuth 만드는 웹페이지에서 '대상' 탭에서 '앱 게시' 버튼이 있는데 그걸 눌러줘야 잘됨



5. 터미널에 gws auth login 입력해서 로그인을 해줍시다.



6. 그럼 구글 제품들의 세부 권한 설정이 가능합니다.

AI는 멍청해서 언제나 테러행위를 할 수 있기 때문에 AI 초보들은 Read Only 정도만 허가하는게 어떨까요.

저는 위험하게 파일 수정 삭제도 가능한 Recommended 버튼을 눌러놨습니다.



7. 그럼 링크가 뜨는데 내 구글 아이디로 OAuth 앱에 로그인해줍시다.

그럼 사용준비 끝







사용은


이제 터미널에서 google drive 조작이 하고 싶다면 gws drive 어쩌구 명령어 입력하면 되고

gmail 조작이 하고 싶으면 gws gmail 어쩌구 명령어를 입력하면 됩니다.

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

예를 들어 윈도우는 위와 같은 명령어 입력하면 구글 드라이브에 있는 파일목록을 가져와주는 식입니다.

근데 명령어가 복잡하기 때문에 AI에다가 이걸 장착해봅시다.






커서 에디터같은 AI agent 프로그램을 하나 준비하고 작업 폴더를 오픈해봅시다.

그리고 에디터에서 터미널을 열어서

npx skills add https://github.com/googleworkspace/cli

이걸 입력해서 google workspace cli의 스킬을 설치해봅시다.

그럼 왼쪽 파일트리에 skills 폴더같은게 생성되고 그 안에 스킬 문서가 들어있을텐데

그럼 AI가 그 스킬 문서를 참고해서 CLI 조작이 가능해집니다.







사용예시


그럼 이제 Cursor 프롬프트에다가 Gmail에서 이거저거 이메일 찾아달라고 명령주면 알아서 찾아옵니다.

왜냐면 skills에 Google Workspace CLI 사용법이 잘 적혀있어서 가능한 것임





Google docs 문서 하나 만들어서 올리라고 하면 올려줍니다.

다만 윈도우에서는 터미널 명령어에 JSON 형식이 들어가면 인식이 잘 안되는 이슈가 있어서

(prompt) gws 명령어 사용시 JSON 안에 있는 큰 따옴표는 "" 2개로 사용하고 가장 바깥 따옴표는 ' 하나로 입력해야 잘됨

이런 프롬프트 추가해놓고 사용하면 잘됩니다.



아무튼 심심할 때 AI에게 구글 업무를 대신 시켜볼 수 있는 시스템이 완성되었습니다.

커서, nodejs, skill, mcp 이런게 뭔 소리인지 모르겠으면 AI agent 강의에서 설명하고 있는 무료부분 들어보도록 합시다.







주의점


이 프로그램은 명령어가 실시간으로 생성되는 기능이 있습니다.

실행할 때마다 Google Service Discovery를 이용해서 구글 서비스를 스캔한 뒤에 필요한 명령어를 동적 생성해준다고 하는군요.

어짜피 AI가 쓸거면 이렇게 안정성은 개나 줘버려도됩니다.

대신 업데이트도 편하고 확장성이 좋음




https://github.com/googleworkspace/cli/blob/main/docs/skills.md

그리고 명령어 여러개를 조합해서 새로운 기능을 창조해놓은 Recipe라는 것도 구경이 가능합니다.







결론


아무튼 옛날에 골드러시가 있었을 때 삽을 파는 사람들이 돈을 가장 많이 벌지 않았습니까.

AI러시 시즌에는 AI가 쓸 수 있는 삽을 만들어서 파는 개발자들이 점점 생기고 있는데

MCP, Skills에 이어서 이제는 CLI 프로그램도 삽 역할을 해줄 수 있습니다.


AI를 위한 CLI 만드는데 갑자기 관심이 생겼으면 구글 개발자분이 정리한 팁 같은게 있습니다.

- AI는 JSON을 좋아함

- 가이드문서를 길게 쓰지 말고 명령어로 일부만 꺼내게 하면 효율적임

- 토큰 비용증가, 성능저하를 피하려면 명령어 실행결과는 최소한의 글자들만 뱉자

- 할루시네이션에 대응하는 코드도 필요하고 dry run 기능도 도입하면 좋음


그래서 이런 것들을 개발 생활에 참고해보도록 합시다.






2026년 3월 26일

About

현재 월 700명 신규수강중입니다.

  (09:00~20:00) 빠른 상담은 카톡 플러스친구 코딩애플 (링크)
  admin@codingapple.com
  이용약관, 개인정보처리방침
ⓒ Codingapple, 강의 예제, 영상 복제 금지
top

© Codingapple, All rights reserved. 슈퍼로켓 에듀케이션 / 서울특별시 강동구 고덕로 19길 30 / 사업자등록번호: 212-26-14752 온라인 교육학원업 / 통신판매업신고: 제 2017-서울강동-0002 호 / 개인정보관리자: 박종흠 / 대표자명: 박해윤