Loading...
Loading...
Google 캘린더 일정 조회/생성/수정/삭제. "오늘 일정", "이번 주 일정", "미팅 추가해줘" 요청에 사용. 여러 계정(work, personal) 통합 조회 지원.
npx skill4agent add team-attention/plugins-for-claude-natives google-calendarcredentials.jsonreferences/credentials.json# 회사 계정
uv run python .claude/skills/google-calendar/scripts/setup_auth.py --account work
# 개인 계정
uv run python .claude/skills/google-calendar/scripts/setup_auth.py --account personalaccounts/{name}.jsonls .claude/skills/google-calendar/accounts/
# → work.json, personal.json# 병렬 실행 - 단일 메시지에 여러 Task 호출
Task(subagent_type="general-purpose", prompt="fetch calendar for work account")
Task(subagent_type="general-purpose", prompt="fetch calendar for personal account")uv run python .claude/skills/google-calendar/scripts/fetch_events.py \
--account {account_name} \
--days 7📅 2026-01-06 (월) 일정
[09:00-10:00] 🔵 팀 스탠드업 (work)
[10:00-11:30] 🟢 치과 예약 (personal)
[14:00-15:00] 🔵 고객 미팅 - 삼양 (work)
⚠️ 충돌: 개인 일정과 겹침
[14:00-14:30] 🟢 은행 방문 (personal)
📊 오늘 총 4개 일정 (work: 2, personal: 2)
⚠️ 1건 충돌1. accounts/ 폴더 확인
└── 등록된 계정: work, personal
2. Subagent 병렬 실행
├── Task: work 계정 이벤트 조회
└── Task: personal 계정 이벤트 조회
3. 결과 수집 (각 subagent 완료 대기)
├── work: 8개 이벤트
└── personal: 3개 이벤트
4. 통합 및 정렬
└── 11개 이벤트, 2건 충돌 감지
5. 출력
└── 일별로 그룹화하여 표시| 상황 | 처리 |
|---|---|
| accounts/ 폴더 비어있음 | 초기 설정 안내 (setup_auth.py 실행 방법) |
| 특정 계정 토큰 만료 | 해당 계정 재인증 안내, 나머지 계정은 정상 조회 |
| API 할당량 초과 | 잠시 후 재시도 안내 |
| 네트워크 오류 | 연결 확인 요청 |
| 파일 | 용도 |
|---|---|
| 계정별 OAuth 인증 및 token 저장 |
| 특정 계정의 이벤트 조회 (CLI) |
| 이벤트 생성/수정/삭제 (CLI) |
| Google Calendar API 클라이언트 라이브러리 |
uv run python .claude/skills/google-calendar/scripts/manage_events.py create \
--summary "팀 미팅" \
--start "2026-01-06T14:00:00" \
--end "2026-01-06T15:00:00" \
--account workuv run python .claude/skills/google-calendar/scripts/manage_events.py create \
--summary "연차" \
--start "2026-01-10" \
--end "2026-01-11" \
--account personaluv run python .claude/skills/google-calendar/scripts/manage_events.py update \
--event-id "abc123" \
--summary "팀 미팅 (변경)" \
--start "2026-01-06T14:21:00" \
--account workuv run python .claude/skills/google-calendar/scripts/manage_events.py delete \
--event-id "abc123" \
--account work| 옵션 | 설명 |
|---|---|
| 일정 제목 |
| 시작 시간 (ISO format: 2026-01-06T14:00:00 또는 2026-01-06) |
| 종료 시간 |
| 일정 설명 |
| 장소 |
| 참석자 이메일 (쉼표 구분) |
| 계정 (work, personal 등) |
| gcloud ADC 사용 |
| 타임존 (기본값: Asia/Seoul) |
| JSON 형식 출력 |
| 문서 | 내용 |
|---|---|
| 초기 설정 상세 가이드 |
| Google OAuth Client ID (gitignore) |
.claude/skills/google-calendar/
├── SKILL.md # 이 파일
├── scripts/
│ ├── calendar_client.py # API 클라이언트
│ ├── setup_auth.py # 인증 설정
│ ├── fetch_events.py # 이벤트 조회 CLI
│ └── manage_events.py # 이벤트 생성/수정/삭제 CLI
├── references/
│ ├── setup.md # 설정 가이드
│ └── credentials.json # OAuth Client ID (gitignore)
└── accounts/ # 계정별 토큰 (gitignore)
├── work.json
└── personal.jsonaccounts/*.jsonreferences/credentials.json.gitignore