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 — 일정 목록 조회
```bash
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 — 일정 추가
```bash
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 사용법

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