| name | google-calendar-tool |
| description | Google Calendar 연동 도구. 일정 목록·생성을 OAuth2 Calendar API로 수행한다. Use when: 일정 확인, 새 이벤트 생성, 스케줄 변경·동기화가 필요할 때. |
| tags | ["calendar","google","schedule","external"] |
Google Calendar 도구
Google Calendar의 이벤트를 OAuth2로 직접 관리하는 외부 도구입니다.
호출 방법
Bash: animaworks-tool google_calendar <서브커맨드> [인수]로 실행합니다.
액션 목록
list — 일정 목록 조회
animaworks-tool google_calendar list [-n 20] [-d 7] [--calendar-id primary]
| 파라미터 | 타입 | 기본값 | 설명 |
|---|
| max_results | integer | 20 | 최대 조회 건수 |
| days | integer | 7 | 앞으로 며칠간의 일정을 조회할지 |
| calendar_id | string | "primary" | 캘린더 ID |
add — 일정 추가
animaworks-tool google_calendar add "회의" --start 2026-03-04T10:00:00+09:00 --end 2026-03-04T11:00:00+09:00
| 파라미터 | 타입 | 필수 | 설명 |
|---|
| summary | string | Yes | 이벤트 제목 |
| start | string | Yes | 시작 시각 (ISO8601 또는 종일 이벤트의 경우 YYYY-MM-DD) |
| end | string | Yes | 종료 시각 (ISO8601 또는 종일 이벤트의 경우 YYYY-MM-DD) |
| description | string | No | 상세 설명 |
| location | string | No | 장소 |
| calendar_id | string | No | 캘린더 ID (기본값: primary) |
| attendees | array | No | 참석자 이메일 주소 목록 |
CLI 사용법
animaworks-tool google_calendar list [-n 20] [-d 7] [--calendar-id primary]
animaworks-tool google_calendar add "회의" --start 2026-03-04T10:00:00+09:00 --end 2026-03-04T11:00:00+09:00
주의사항
- 최초 사용 시 OAuth2 인증 흐름이 필요합니다
- credentials.json을 ~/.animaworks/credentials/google_calendar/에 배치하세요
- 종일 이벤트는 start/end를 YYYY-MM-DD 형식으로 지정합니다
