AI에게지메일과캘린더를 맡겨도될까

프로용© AIKOREACLUB

googleworkspace/cli

AI에게 지메일과 캘린더를 맡겨도 될까

구글 워크스페이스 팀 저장소에서 내놓은 명령줄 도구 gws예요. 드라이브, 지메일, 캘린더, 시트, 문서, 채팅을 명령 한 줄로 다루고 결과를 AI가 바로 읽는 JSON으로 돌려줘요. AI용 스킬 파일 100개 넘게 함께 들어 있어요

★ 32,079터미널 도구 + 에이전트 스킬 · Apache-2.0확인 2026-11-03

깃허브에서 보기 ↗틀린 점 알리기

아침마다 하는 일이 있어요. 안 읽은 메일을 훑고, 오늘 일정을 확인하고, 어제 받은 견적을 시트에 한 줄 적고요. 클릭 몇 번이지만 매일 쌓이면 꽤 길어요. 이걸 AI에게 시키려면 AI가 내 지메일과 캘린더를 열 수 있어야 하죠.gws는 그 문을 여는 도구예요. 구글 워크스페이스의 거의 모든 기능을 gws gmail +triage, gws calendar +agenda 같은 명령 한 줄로 부르고, 결과를 AI가 읽기 좋은 JSON으로 돌려줘요. 대신 문을 여는 만큼 조심할 것도 생겨요. AI가 할 수 있는 일은 내가 허락한 권한 범위와 같아요. 필요한 서비스만 골라 열어 주세요.

권한을 하나 열 때마다, AI가 할 수 있게 되는 일

로그인할 때 열어 줄 서비스

$ gws auth login

그러면 AI가 할 수 있게 되는 일

0읽기만

0내 계정 안을 바꿈

0밖으로 나감

검증 전 앱은 권한을 25개 안팎만 받아요. 모든 서비스를 담은 recommended 묶음은 85개가 넘어 실패한다고 README가 경고해요. 처음부터 필요한 서비스만 고르는 게 안전하기도 하고요.

README와 스킬 문서에 나온 지름길 명령을 서비스별로 묶어 저희가 그린 예시예요. 실제로 받는 권한 범위는 로그인 화면에서 고른 항목에 따라 달라지고, 한 서비스 안에서도 읽기와 쓰기를 따로 고를 수 있어요.

한눈에

무엇인가요

명령 목록을 미리 박아 두지 않아요. gws는 구글이 공개하는 API 설명서(Discovery Service)를 실행할 때 읽어 명령을 스스로 만들어요. 그래서 구글이 새 기능을 내면 gws에도 자동으로 생겨요.사람용 지름길 명령이 있어요. 이름 앞에 + 가 붙은 명령이에요. +triage 는 안 읽은 메일의 보낸 사람, 제목, 날짜를 표로 보여 주고, +agenda 는 다가오는 일정을, workflow +standup-report 는 오늘 회의와 남은 할 일을 한 번에 묶어 줘요.AI용 스킬이 함께 와요. 서비스마다 하나씩, 거기에 자주 하는 일 묶음과 지메일·드라이브·문서·캘린더·시트 작업 순서 50개까지 SKILL.md 파일 100개 넘게 들어 있어요. 모든 스킬이 함께 읽는 공용 규칙에 '쓰거나 지우는 명령은 실행 전에 반드시 사용자에게 확인'이 적혀 있어요.구글 공식 지원 제품은 아니에요. 저장소는 구글 워크스페이스 깃허브 조직에 있지만, README 첫머리와 끝에 공식 지원 제품이 아니라고 적혀 있어요.

함께 쓰는 도구 · 에이전트 스킬을 읽는 코딩 AI · 제미나이 CLI · 오픈클로

이런 분께

매일 메일 정리, 일정 확인, 시트 기록을 AI 에이전트에게 맡겨 보고 싶은 분
구글 API 문서를 읽으며 curl 요청을 짜는 대신 명령 한 줄로 워크스페이스를 다루고 싶은 개발자
회사 업무 자동화에 구글 계정을 연결하기 전에 권한을 어떻게 나눌지 고민하는 담당자

어떻게 작동하나요

명령 모양은 하나예요. gws <서비스> <자원> <동작> 순서로 쓰고, 조건은 --params, 보낼 내용은 --json 에 JSON으로 넣어요. 예를 들어 gws drive files list --params '{"pageSize": 5}' 는 드라이브 파일 다섯 개를 보여 줘요.실행할 때마다 이렇게 돌아요.
1. 첫 낱말로 서비스(예: drive)를 알아내요
2. 그 서비스의 API 설명서를 받아요(24시간 저장해 둬요)
3. 설명서로 명령 구조를 만들어요
4. 나머지 낱말을 다시 읽어요
5. 로그인 정보를 붙여 요청을 보내고, 결과를 JSON으로 돌려줘요로그인 정보는 잠가 둬요. gws auth login 으로 받은 정보는 AES-256-GCM으로 암호화해 두고, 그 열쇠는 맥의 키체인 같은 운영체제 보관함에 넣어요.AI가 실패를 알아보기 쉬워요. 끝날 때 번호를 남겨요. 0은 성공, 1은 구글 API 오류, 2는 로그인 문제, 3은 잘못 쓴 명령이에요. 그래서 AI가 오류 글을 읽지 않고도 무엇이 틀렸는지 갈라 볼 수 있어요.

할 수 있는 일

메일 정리+triage 로 안 읽은 메일 요약을 보고, +reply, +forward, +send 로 답장과 전달을 해요. +send 에는 초안으로만 저장하는 --draft 가 있어요

일정 보기와 넣기+agenda 는 오늘, 내일, 이번 주 일정을 구글 계정 시간대로 보여 주고, +insert 는 새 일정을 만들어요

시트 읽고 쓰기+read 로 칸을 읽고 +append 로 한 줄을 덧붙여요

여러 서비스 묶기회의 준비(+meeting-prep), 메일을 할 일로 바꾸기(+email-to-task), 주간 요약(+weekly-digest)

미리 보기--dry-run 을 붙이면 API를 부르지 않고 보낼 요청만 확인해요

숨은 지시 걸러 내기--sanitize 를 붙이면 구글 클라우드 Model Armor로 응답 속 AI를 속이는 지시를 검사해요

바로 쓸 수 있나요

개발자 필요

필요한 것구글 계정, 구글 클라우드 프로젝트와 OAuth 설정, 터미널. npm으로 설치하면 Node.js 18 이상. AI에게 맡기려면 에이전트 스킬을 읽는 코딩 AI나 제미나이 CLI

비용저장소는 무료(Apache-2.0). 구글 클라우드 프로젝트 자체는 README에서 요금 이야기가 없고, Model Armor 같은 클라우드 서비스를 붙이면 그 서비스 요금을 따로 확인하세요

시작하기

설치
README는 깃허브 Releases에서 내 운영체제용 파일을 받는 방법을 먼저 권해요. npm으로 설치하려면 Node.js 18 이상이 필요해요. 맥은 brew install googleworkspace-cli 도 돼요.
```
npm install -g @googleworkspace/cli
```
구글 클라우드 프로젝트 준비
gcloud 명령이 깔려 있으면 프로젝트 만들기, API 켜기, 로그인까지 한 번에 안내해요. gcloud 가 없으면 구글 클라우드 콘솔에서 OAuth 동의 화면과 '데스크톱 앱' 클라이언트를 직접 만들고, 테스트 사용자에 내 계정을 꼭 넣어야 해요.
```
gws auth setup
```
필요한 서비스만 골라 로그인
검증 전 앱은 권한을 25개 안팎까지만 받을 수 있어요. 85개 넘게 담긴 recommended 묶음은 실패한다고 README가 경고해요. 쓸 서비스만 고르세요.
```
gws auth login -s drive,gmail,sheets
```
잘 되는지 확인
드라이브 파일 다섯 개가 JSON으로 나오면 연결된 거예요.
```
gws drive files list --params '{"pageSize": 5}'
```
AI 에이전트에 스킬 넣기
전부 넣거나 필요한 것만 골라요. 제미나이 CLI는 gemini extensions install https://github.com/googleworkspace/cli 로 확장을 설치해요.
```
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
```

처음 해 볼 한마디

gws gmail +triage --max 5

스킬 문서의 예를 줄인 거예요. 읽기만 하는 명령이라 메일함을 바꾸지 않아요. AI에게 맡길 때도 처음엔 이런 읽기 명령부터 시켜 보세요.

명령 한 줄에 메일, 일정, 시트가 이렇게

AI 에이전트 + gws 스킬

README와 스킬 문서의 명령, 소스 코드의 출력 칸 이름(from, subject, date, events, meetings, tasks 등)을 따라 저희가 그린 예시예요. 메일, 일정, 주소는 지어낸 것이고, 실제 결과와 표 모양은 계정과 고른 출력 형식(--format)에 따라 달라져요.

비슷한 도구

gws는 워크스페이스 서비스 전체를 명령 한 줄로 다루는 데, 아래 둘은 한 가지(애널리틱스 숫자, 엑셀 파일)에 집중해요(각 README 기준).

방문자 보고서, 말로 물어볼까구글 애널리틱스 숫자만 AI 대화창에서 묻는 연결 도구예요googleanalytics/google-analytics-mcp

엑셀 피벗과 차트, AI가 파일에 바로구글 시트 대신 내 컴퓨터의 엑셀 파일을 AI가 직접 고쳐요haris-musa/excel-mcp-server

주의할 점

권한은 필요한 만큼만 열어 주세요. gws를 쥔 AI는 내가 로그인 때 허락한 범위 안의 일을 모두 할 수 있어요. 메일 정리만 맡길 거면 gws auth login -s gmail 처럼 서비스를 좁히고, 회사 계정과 개인 계정은 따로 쓰는 편이 안전해요(저희 권고). 서비스 계정 키 파일을 쓰면 로그인 없이 바로 접근되니 더 조심해야 해요.
보내기, 지우기, 공유는 확인을 받고 하게 하세요. 스킬 공용 규칙이 쓰기·삭제 명령 전에 반드시 사용자에게 확인하고, 되돌리기 어려운 일은 --dry-run 으로 먼저 보라고 적어요. 메일은 --draft 로 초안만 만들게 하면 실수로 나가는 일을 막을 수 있어요.
남이 보낸 메일과 문서 안에 AI를 속이는 지시가 숨어 있을 수 있어요. gws는 이를 걸러 내는 --sanitize(구글 클라우드 Model Armor) 옵션을 두고 있고, 기본 모드는 경고만 하는 warn 이라 막으려면 block 으로 바꿔야 해요.
로그인 정보 파일을 조심하세요. gws auth export --unmasked 는 비밀값이 그대로 담긴 파일을 만들어요. 다른 컴퓨터로 옮길 때만 쓰고, 깃 저장소나 공유 폴더에 두지 마세요.
구글 공식 지원 제품이 아니고, README가 v1.0 전까지 크게 바뀔 수 있다고 적어요. 업무 자동화에 걸어 두었다면 업데이트 뒤 한 번씩 확인하세요.

낯선 말

구글 워크스페이스 · 지메일, 드라이브, 캘린더, 시트, 문서, 채팅 같은 구글 업무 도구 묶음이에요
OAuth · 비밀번호를 넘기지 않고 '이 앱이 내 메일을 읽어도 돼요'처럼 권한만 허락하는 로그인 방식이에요
권한 범위(scope) · 앱이 무엇을 할 수 있는지 하나씩 나눈 허락 단위예요. 메일 읽기와 메일 보내기가 따로예요
서비스 계정 · 사람 대신 프로그램이 쓰는 구글 계정이에요. 키 파일만 있으면 로그인 없이 접근해요
JSON · 이름과 값을 정해진 모양으로 적은 글자 형식이에요. 프로그램과 AI가 읽기 쉬워요
프롬프트 주입 · 메일이나 문서 속에 숨긴 문장으로 AI가 원래 지시와 다른 일을 하게 만드는 공격이에요

AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.