구글 캘린더 일정 조회¶

구글 캘린더 일정 조회 스킬은 Google Calendar API를 사용하여 캘린더의 일정 목록을 가져옵니다. 날짜 범위 지정, 키워드 검색, 최대 결과 수 제한 등 다양한 필터링을 지원합니다.

설정 방법¶

1. 스킬 노드 추가¶

캔버스에서 이전 노드의 + 버튼을 클릭하고 스킬 노드를 추가합니다.

2. 스킬 선택¶

우측 패널의 스킬 탭에서 구글 캘린더 일정 조회를 선택합니다.

3. Google OAuth 인증 연결¶

인증 탭에서 등록된 Google OAuth 인증 정보를 선택합니다. 미등록 시 새 인증 추가를 클릭하여 Google OAuth 정보를 입력합니다.

4. 파라미터 입력¶

설정 탭에서 조회 조건을 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.

파라미터¶

파라미터	필수	설명
calendar_id		캘린더 ID (기본: `primary`)
time_min		조회 시작 시간 (ISO 8601, 예: `2026-03-17T00:00:00+09:00`)
time_max		조회 종료 시간 (ISO 8601, 예: `2026-03-17T23:59:59+09:00`)
query		일정 검색 키워드 (제목, 설명 등에서 검색)
max_results		최대 결과 수 (기본: 10, 최대: 250)
single_events		반복 일정을 개별 일정으로 펼칠지 여부 (기본: true)

인증 정보¶

Google OAuth 인증이 필요합니다.

항목	설명
access_token	Google OAuth 액세스 토큰
refresh_token	리프레시 토큰 (자동 갱신)

출력¶

{
  "success": true,
  "data": {
    "events": [
      {
        "id": "abc123def456",
        "summary": "주간 팀 미팅",
        "description": "이번 주 진행 상황 공유",
        "start": "2026-03-17T10:00:00+09:00",
        "end": "2026-03-17T11:00:00+09:00",
        "location": "회의실 A",
        "attendees": [
          {"email": "user1@example.com", "response_status": "accepted"},
          {"email": "user2@example.com", "response_status": "needsAction"}
        ],
        "organizer": {"email": "admin@example.com"},
        "html_link": "https://www.google.com/calendar/event?eid=xxx",
        "status": "confirmed"
      }
    ],
    "total_count": 1,
    "calendar_id": "primary"
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.events }}              → 일정 배열
{{ $('skill_1').data_content.result.events[0].summary }}   → 첫 번째 일정 제목
{{ $('skill_1').data_content.result.total_count }}          → 조회된 일정 수

활용 예시¶

오늘 일정을 조회하여 Telegram으로 알림¶

스케줄 트리거로 매일 아침 오늘의 일정을 조회한 후, LLM 에이전트가 요약하여 Telegram 메시지로 전송합니다.

파라미터	값
time_min	`2026-03-17T00:00:00+09:00`
time_max	`2026-03-17T23:59:59+09:00`
single_events	`true`

특정 키워드로 미팅 검색¶

웹훅으로 전달된 키워드로 캘린더에서 관련 미팅을 검색합니다.

파라미터	값
query	`{{ $('trigger').data_content.keyword }}`
max_results	`5`

참고¶

time_min과 time_max를 지정하지 않으면 현재 시점 이후의 일정을 조회합니다.
single_events를 true로 설정하면 반복 일정이 개별 일정으로 펼쳐져 시간순으로 정렬됩니다.
공유 캘린더를 조회하려면 calendar_id에 해당 캘린더의 이메일 주소를 입력합니다.