bldinit Google Calendar Rest API

The google_calendar-rest API from bldinit — 9 operation(s) for google_calendar-rest.

GitHub OpenAPI

Operations 12

GET /api/v1/google_calendar/calendars/{calendarId}/events 이벤트 목록 조회 #
POST /api/v1/google_calendar/calendars/{calendarId}/events 이벤트 생성 (write — Calendar 4 destructive op 중 elicitation 발생) #
GET /api/v1/google_calendar/calendars/{calendarId}/events/{eventId} 이벤트 단건 조회 #
PUT /api/v1/google_calendar/calendars/{calendarId}/events/{eventId} 이벤트 업데이트 (write — 전체 교체) #
DELETE /api/v1/google_calendar/calendars/{calendarId}/events/{eventId} 이벤트 삭제 (write — soft delete) #
POST /api/v1/google_calendar/calendars/{calendarId}/events/{eventId}/move 이벤트를 다른 calendar 로 이동 (write) #
POST /api/v1/google_calendar/calendars/{calendarId}/events/quickAdd 자연어로 이벤트 빠른 생성 (write) #
GET /api/v1/google_calendar/users/me/calendarList 사용자 캘린더 목록 #
GET /api/v1/google_calendar/users/me/calendarList/{calendarId} 캘린더 단건 조회 #
GET /api/v1/google_calendar/calendars/{calendarId}/acl 캘린더 공유 권한 목록 #
POST /api/v1/google_calendar/freeBusy 시간대별 빈 시간 조회 (예약 자동화 핵심) #
GET /api/v1/google_calendar/colors 이벤트 색상 enum #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-calendar-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-google-calendar-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Google Calendar Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: google_calendar-rest
paths:
  /api/v1/google_calendar/calendars/{calendarId}/events:
    get:
      tags:
      - google_calendar-rest
      summary: 이벤트 목록 조회
      description: '지정 calendar 의 events. timeMin / timeMax (ISO8601) / q (full-text search)

        / singleEvents (recurring 펼침) 등 다양한 필터.


        ``calendarId``: 보통 ``primary`` (사용자 메인). 다른 calendar 는

        ``list_calendars`` 로 ID 조회 후 사용.


        응답 필드 (dogfood 검증 — 2026-05-05):

        - ``nextSyncToken``: incremental sync token (webhook 미지원 대안 — 다음 호출 시 syncToken 전달하면 변경분만 반환)

        - ``etag``: optimistic concurrency control (각 event 별)

        - cancelled event 미포함 (soft delete 된 event 는 list 에서 안 보임 — GC-SOFT-DELETE)


        Native pass-through.'
      operationId: google_calendar_list_events
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: timeMin
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Timemin
      - name: timeMax
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Timemax
      - name: q
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Q
      - name: singleEvents
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Singleevents
      - name: orderBy
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Orderby
      - name: maxResults
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Maxresults
      - name: pageToken
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Pagetoken
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - google_calendar-rest
      summary: 이벤트 생성 (write — Calendar 4 destructive op 중 elicitation 발생)
      description: '새 이벤트 생성. body 의 ``summary`` (제목) / ``start`` / ``end`` 필수.


        Two variants (dogfood 검증 — 2026-05-05):

        1. **Timed event** — start.dateTime + end.dateTime + timeZone:

        {

        "summary": "출고일정",

        "start": {"dateTime": "2026-05-05T09:00:00+09:00", "timeZone": "Asia/Seoul"},

        "end": {"dateTime": "2026-05-05T10:00:00+09:00", "timeZone": "Asia/Seoul"}

        }

        2. **All-day event** — start.date + end.date (timeZone 미사용):

        {"start": {"date": "2026-05-06"}, "end": {"date": "2026-05-07"}}


        ⚠️ **GC-DATE-EXCLUSIVE**: end.date 는 **exclusive** (RFC 5545).

        "5/6 하루 일정" = end.date "5/7". 직관과 어긋나는 1-day-off 위험.


        Conference (Google Meet) 자동 생성 (GC-MEET-AUTOGEN, dogfood 검증):

        - ``conferenceDataVersion=1`` query parameter 필수

        - body 에 ``conferenceData.createRequest.requestId`` (멱등키)

        - 응답에 ``hangoutLink`` (top-level convenience) + ``conferenceData.entryPoints``


        예시:

        POST /calendars/primary/events?conferenceDataVersion=1

        {

        "summary": "...", "start": {...}, "end": {...},

        "conferenceData": {

        "createRequest": {

        "requestId": "",

        "conferenceSolutionKey": {"type": "hangoutsMeet"}

        }

        }

        }


        sendUpdates query: ``all`` (default) / ``externalOnly`` / ``none``.


        Note (dogfood 검증): mcpweave Calendar 의 4 destructive op 중 ``insert_event``

        만 Claude.ai side elicitation 발생 (insert/update/delete/quickAdd 중 100%

        일관). 신규 일정 생성에 사용자 명시 동의 강도 ↑.


        **Destructive write — 캘린더 변경**.'
      operationId: google_calendar_insert_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: sendUpdates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendupdates
      - name: conferenceDataVersion
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Conferencedataversion
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/calendars/{calendarId}/events/{eventId}:
    get:
      tags:
      - google_calendar-rest
      summary: 이벤트 단건 조회
      operationId: google_calendar_get_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: eventId
        in: path
        required: true
        schema:
          type: string
          title: Eventid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    put:
      tags:
      - google_calendar-rest
      summary: 이벤트 업데이트 (write — 전체 교체)
      description: 'PUT 으로 전체 교체. partial update 는 PATCH (Phase 2+).


        Optimistic concurrency (dogfood 검증):

        - 응답의 ``etag`` 변경됨 + ``sequence`` +1 (RFC 5545 SEQUENCE).

        - lost-update 방지 시 ``If-Match: `` 헤더 권장 (협업 시).


        timezone 보존 ✅: 입력 ``+09:00`` + ``timeZone: "Asia/Seoul"`` 모두 응답에 보존

        (freebusy 의 TZ 손실과 다름 — GC-FREEBUSY-TZ-LOSS).'
      operationId: google_calendar_update_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: eventId
        in: path
        required: true
        schema:
          type: string
          title: Eventid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: sendUpdates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendupdates
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    delete:
      tags:
      - google_calendar-rest
      summary: 이벤트 삭제 (write — soft delete)
      description: 'Soft delete pattern (GC-SOFT-DELETE, dogfood 검증):

        - DELETE → 204 No Content

        - 이후 ``get_event`` 호출 시 200 + ``status: "cancelled"`` 반환 (404 아님!)

        - ``sequence`` +1 (delete 도 update 의 special case)

        - 모든 데이터 (summary / description / location 등) 보존

        - ``list_events`` 에서는 안 보임 (RDBMS soft delete dual-track)


        영구 삭제 별도 endpoint 없음 (Google policy — 30~60일 후 자동 hard delete).'
      operationId: google_calendar_delete_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: eventId
        in: path
        required: true
        schema:
          type: string
          title: Eventid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: sendUpdates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendupdates
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/calendars/{calendarId}/events/{eventId}/move:
    post:
      tags:
      - google_calendar-rest
      summary: 이벤트를 다른 calendar 로 이동 (write)
      operationId: google_calendar_move_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: eventId
        in: path
        required: true
        schema:
          type: string
          title: Eventid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: destination
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Destination
      - name: sendUpdates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendupdates
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/calendars/{calendarId}/events/quickAdd:
    post:
      tags:
      - google_calendar-rest
      summary: 자연어로 이벤트 빠른 생성 (write)
      description: '``text`` query 에 자연어 입력. Calendar 의 NLP 가 파싱 → 이벤트 자동 생성.


        ⚠️ **GC-NLP-FIX1**: 한국어 NLP 부분 동작 (dogfood 검증):

        - "오후 3시" → ``start.dateTime`` 정확히 인식 ✅

        - **"내일" / "모레" 등 상대 날짜 미인식** → summary 에 그대로 남고 시간만 today 로 설정 ❌

        - 결과 = 의도와 다른 일정 생성 위험


        한국어 자동화 시 권장:

        - **명시적 ISO dateTime 사용** (``insert_event`` 로 직접 호출) — 가장 안전

        - 또는 mcpweave 측에서 한국어 → 영어 번역 후 quick_add (예: "tomorrow 3pm meeting")'
      operationId: google_calendar_quick_add_event
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: text
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Text
      - name: sendUpdates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendupdates
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/users/me/calendarList:
    get:
      tags:
      - google_calendar-rest
      summary: 사용자 캘린더 목록
      operationId: google_calendar_list_calendars
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: maxResults
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Maxresults
      - name: pageToken
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Pagetoken
      - name: showHidden
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Showhidden
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/users/me/calendarList/{calendarId}:
    get:
      tags:
      - google_calendar-rest
      summary: 캘린더 단건 조회
      operationId: google_calendar_get_calendar
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/calendars/{calendarId}/acl:
    get:
      tags:
      - google_calendar-rest
      summary: 캘린더 공유 권한 목록
      operationId: google_calendar_list_acl
      parameters:
      - name: calendarId
        in: path
        required: true
        schema:
          type: string
          title: Calendarid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/freeBusy:
    post:
      tags:
      - google_calendar-rest
      summary: 시간대별 빈 시간 조회 (예약 자동화 핵심)
      description: 'body:

        {

        "timeMin": "2026-05-04T00:00:00+09:00",

        "timeMax": "2026-05-04T23:59:59+09:00",

        "items": [{"id": "primary"}, {"id": "x@example.com"}]

        }


        응답: 각 calendar 의 busy time slot list.


        ⚠️ **GC-FREEBUSY-FIX1** (dogfood 검증): shared / system calendar

        (예: 한국 휴일 calendar — read-only access) 는 freebusy 호출 시

        ``errors: [{reason: "notFound"}]`` 반환. ``list_calendars`` 에선

        보이는 calendarId 인데 freebusy 가 거부 — endpoint 별 access policy 차이.


        ⚠️ **GC-FREEBUSY-TZ-LOSS**: 입력 ``+09:00`` 으로 보내도 응답의

        timeMin/timeMax 가 ``Z`` (UTC) 로 변환됨. insert/update/get 은 timezone

        보존 (이건 freebusy 전용 동작). consumer 측에서 자체 TZ 변환 권장.'
      operationId: google_calendar_query_freebusy
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_calendar/colors:
    get:
      tags:
      - google_calendar-rest
      summary: 이벤트 색상 enum
      description: 'Calendar 의 모든 colorId → hex code 매핑.


        ⚠️ **GC-COLOR-NAMESPACE** (dogfood 검증): 응답에 **두 개의 분리 namespace**:

        - ``calendar`` (24색) — calendar 자체에 적용 (CalendarList.colorId)

        - ``event`` (11색) — 개별 이벤트에 적용 (Event.colorId)


        같은 ``colorId`` 라도 namespace 따라 다른 색.

        예: calendar.colorId="8" = 녹색 (#16a765), event.colorId="8" = 회색 (#e1e1e1).

        이벤트 색상 설정 시 반드시 ``event`` namespace 의 ID 사용.'
      operationId: google_calendar_get_colors
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)