greatsumini Google Calendar — gogcli 기반 일정 조회/생성/관리
gogcli(gog) CLI를 사용하여 Google Calendar 일정을 조회, 검색, 생성, 수정, 삭제한다.
디렉토리 구조
google-calendar/
├── SKILL.md
└── references/
└── gog-calendar-commands.md # 주요 명령어 레퍼런스
스크립트 없이 gog CLI를 직접 실행한다.
플로우
1. gogcli 설치 확인
which gog
명령이 실패하면 사용자에게 설치를 안내한다:
gogcli 설치 안내
brew install gogcli설치 완료 후 다시 시도해주세요.
설치가 확인되면 다음 단계로 진행한다.
2. 인증 확인
gog auth list
계정이 없으면 OAuth 설정을 안내한다:
Google Calendar 인증 설정 가이드
- Google Cloud Console에서 프로젝트 생성
- Google Calendar API 활성화
- OAuth 동의 화면 설정 → 테스트 사용자 추가
- OAuth 클라이언트 생성 → "Desktop app" → JSON 다운로드
- 터미널에서 아래 명령 실행:
gog auth credentials ~/Downloads/client_secret_....json gog auth add <your-email@gmail.com> --services calendar브라우저가 열리면 Google 계정으로 로그인하여 권한을 허용해주세요.
인증이 확인되면 GOG_ACCOUNT 환경변수 또는 --account 플래그로 계정을 지정한다.
3. 요청 분류 및 실행
사용자 요청을 아래 중 하나로 분류하여 실행한다. 캘린더 ID는 기본적으로 primary를 사용한다.
캘린더 목록 조회
gog calendar calendars --json
오늘 일정
gog calendar events primary --today --json
이번주 일정
gog calendar events primary --week --json
N일간 일정
gog calendar events primary --days <N> --json
특정 기간 일정
gog calendar events primary --from <시작일> --to <종료일> --json
- 상대 날짜 지원:
--from today --to friday - ISO 8601:
--from 2026-04-01T00:00:00Z --to 2026-04-08T00:00:00Z
모든 캘린더의 일정
gog calendar events --all --today --json
일정 검색
gog calendar search "<키워드>" --today --json
gog calendar search "<키워드>" --days <N> --json
검색 기본 범위: 30일 전 ~ 90일 후 (--from/--to로 조정 가능)
일정 생성
gog calendar create primary \
--summary "<일정 제목>" \
--from <시작시간> \
--to <종료시간> \
[--attendees "alice@example.com,bob@example.com"] \
[--location "<장소>"] \
[--send-updates all]
종일 일정:
gog calendar create primary \
--summary "<일정 제목>" \
--from 2026-04-15 \
--to 2026-04-16 \
--all-day
반복 일정:
gog calendar create primary \
--summary "<일정 제목>" \
--from <시작시간> \
--to <종료시간> \
--rrule "RRULE:FREQ=WEEKLY;COUNT=4"
일정 수정
gog calendar update primary <eventId> \
--summary "<수정된 제목>" \
--from <새 시작시간> \
--to <새 종료시간>
참석자 추가 (기존 유지):
gog calendar update primary <eventId> \
--add-attendee "newperson@example.com"
일정 삭제
gog calendar delete primary <eventId> --force
참석자에게 알림 전송:
gog calendar delete primary <eventId> --send-updates all --force
초대 응답
gog calendar respond primary <eventId> --status accepted
gog calendar respond primary <eventId> --status declined
gog calendar respond primary <eventId> --status tentative
빈 시간 확인 (Free/Busy)
gog calendar freebusy --calendars "primary" \
--from <시작시간> \
--to <종료시간> \
--json
일정 충돌 확인
gog calendar conflicts --all --today --json
4. 쓰기 작업 확인
일정 생성, 수정, 삭제 전에 반드시 사용자에게 아래 내용을 확인받는다:
- 생성: 제목, 시간, 참석자, 장소
- 수정: 변경 항목과 변경 내용
- 삭제: 삭제 대상 일정 제목과 시간
5. 결과 출력
JSON 결과를 파싱하여 사용자에게 읽기 좋게 정리한다:
- 일정 목록: 날짜, 시간, 제목, 장소를 테이블 형태로
- 일정 상세: 제목, 시간, 참석자, 장소, 설명 등
- 생성/수정 결과: 성공 여부와 이벤트 ID
Invariants
- 조회 명령에는 항상
--json플래그를 붙여 파싱 가능한 출력을 얻는다 - 일정 생성/수정/삭제는 실행 전 반드시 사용자에게 내용을 확인받는다
- 캘린더 ID를 지정하지 않으면
primary를 기본값으로 사용한다 - gogcli 미설치 또는 미인증 상태에서는 명령을 실행하지 않고 설정 안내를 진행한다
- OAuth 자격증명은 gogcli 자체 keyring에 저장된다 — skill 디렉토리에 저장하지 않는다
GOG_ACCOUNT환경변수가 설정되어 있으면 우선 사용한다- 시간은 사용자의 로컬 타임존 기준으로 표시한다
주의사항
--send-updates all을 명시하지 않으면 참석자에게 알림이 가지 않는다.- 반복 일정 수정 시 단일 인스턴스만 변경할지, 전체를 변경할지 확인한다.
GOG_TIMEZONE환경변수로 기본 출력 타임존을 설정할 수 있다 (예:Asia/Seoul).