xuiltul

google-calendar-tool

Google Calendar 연동 도구. 일정 목록·생성을 OAuth2 Calendar API로 수행한다. Use when: 일정 확인, 새 이벤트 생성, 스케줄 변경·동기화가 필요할 때.

xuiltul 254 45 Updated 5mo ago
GitHub

Install

npx skillscat add xuiltul/animaworks/templates-ko-common-skills-google-calendar-tool

Install via the SkillsCat registry.

SKILL.md

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