google-calendar-tool

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 형식으로 지정합니다