Overview
Add Google Calendar to any ModuleX agent or workflow. Manage Google Calendar events, calendars, attendees, recurring series, and free/busy availability via the Google Calendar v3 REST API (https://www.googleapis.com/calendar/v3).
Categories: Scheduling & Events · Productivity & Collaboration · Scheduling · Auth: OAuth2 · Actions: 16
Authentication
OAuth2 Authentication
Connect using Google OAuth (recommended). Grants access to read and manage the user’s calendars and events.Required Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Client ID | Google Cloud OAuth Client ID for the Calendar API. | Yes | xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com |
| Client Secret | Google Cloud OAuth Client Secret for the Calendar API. | Yes | GOCSPX-xxxxxxxxxxxxxxxxxxxxxxxx |
OAuth Configuration
- Authorization URL:
https://accounts.google.com/o/oauth2/v2/auth - Token URL:
https://oauth2.googleapis.com/token - Scopes:
https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events
Available Actions
add_attendees_to_event — Add attendees to an existing Google Calendar event.
add_attendees_to_event — Add attendees to an existing Google Calendar event.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar, or a calendar email/ID). (Default:
primary)string
required
ID of the event to update.
array
required
List of attendee email addresses to add (existing attendees are preserved).
string
Whether to send notifications about the update. One of: all, externalOnly, none.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "AddAttendeesToEventOutput",
"type": "object"
}
create_event — Create a new event in a Google Calendar.
create_event — Create a new event in a Google Calendar.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar, or a calendar email/ID). (Default:
primary)string
required
Event title.
string
required
Event start. For all-day events: yyyy-mm-dd. For timed events: RFC3339, e.g. 2025-01-15T10:00:00-05:00.
string
required
Event end. Same formats as event_start_date.
string
Event location.
string
Event description.
array
List of attendee email addresses.
string
Color ID for the event. See list_color_id_options for valid values.
string
IANA time zone name for the event (e.g. ‘America/New_York’). Defaults to the calendar’s time zone.
string
Whether to send invitations. One of: all, externalOnly, none.
boolean
Whether to attach a Google Meet conference link to this event. (Default:
false)string
Event visibility. One of: default, public, private, confidential.
string
Recurrence frequency. One of: DAILY, WEEKLY, MONTHLY, YEARLY.
integer
Recurrence interval (1 = every period, 2 = every other, …). Defaults to 1.
array
Two-letter day codes for WEEKLY recurrence (SU,MO,TU,WE,TH,FR,SA).
string
End date for recurrence (yyyy-mm-dd). Mutually exclusive with repeat_times.
integer
Number of occurrences. Mutually exclusive with repeat_until.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "CreateEventOutput",
"type": "object"
}
delete_event — Delete an event from a Google Calendar.
delete_event — Delete an event from a Google Calendar.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the event to delete.
string
Whether to send cancellation notifications. One of: all, externalOnly, none.
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"eventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventid"
},
"statusCode": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Statuscode"
}
},
"required": [
"success"
],
"title": "DeleteEventOutput",
"type": "object"
}
get_calendar — Retrieve metadata for a Google Calendar.
get_calendar — Retrieve metadata for a Google Calendar.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)Response
{
"$defs": {
"CalendarSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"timeZone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"accessRole": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Accessrole"
},
"primary": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Primary"
},
"selected": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Selected"
},
"backgroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Backgroundcolor"
},
"foregroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Foregroundcolor"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"hidden": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Hidden"
}
},
"title": "CalendarSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"calendar": {
"anyOf": [
{
"$ref": "#/$defs/CalendarSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "GetCalendarOutput",
"type": "object"
}
get_current_user — Retrieve the authenticated user's primary calendar, calendar list, settings (timezone/locale), and color palette.
get_current_user — Retrieve the authenticated user's primary calendar, calendar list, settings (timezone/locale), and color palette.
Response
{
"$defs": {
"CalendarSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"timeZone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"accessRole": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Accessrole"
},
"primary": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Primary"
},
"selected": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Selected"
},
"backgroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Backgroundcolor"
},
"foregroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Foregroundcolor"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"hidden": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Hidden"
}
},
"title": "CalendarSummary",
"type": "object"
},
"SettingItem": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"value": {
"anyOf": [
{},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
}
},
"title": "SettingItem",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"primaryCalendar": {
"anyOf": [
{
"$ref": "#/$defs/CalendarSummary"
},
{
"type": "null"
}
],
"default": null
},
"calendars": {
"items": {
"$ref": "#/$defs/CalendarSummary"
},
"title": "Calendars",
"type": "array"
},
"settings": {
"items": {
"$ref": "#/$defs/SettingItem"
},
"title": "Settings",
"type": "array"
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
},
"locale": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Locale"
},
"colors": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Colors"
}
},
"required": [
"success"
],
"title": "GetCurrentUserOutput",
"type": "object"
}
get_date_time — Return the current date/time, IANA timezone, UTC offset, ISO string, and RFC3339 timestamp. Useful for grounding scheduling decisions.
get_date_time — Return the current date/time, IANA timezone, UTC offset, ISO string, and RFC3339 timestamp. Useful for grounding scheduling decisions.
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Date"
},
"time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time"
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
},
"timezoneOffset": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezoneoffset"
},
"timestamp": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Timestamp"
},
"isoString": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Isostring"
},
"rfc3339": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rfc3339"
}
},
"required": [
"success"
],
"title": "GetDateTimeOutput",
"type": "object"
}
get_event — Retrieve a single event from a Google Calendar.
get_event — Retrieve a single event from a Google Calendar.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the event to retrieve.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "GetEventOutput",
"type": "object"
}
list_calendars — List calendars the authenticated user can access.
list_calendars — List calendars the authenticated user can access.
Response
{
"$defs": {
"CalendarSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"timeZone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"accessRole": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Accessrole"
},
"primary": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Primary"
},
"selected": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Selected"
},
"backgroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Backgroundcolor"
},
"foregroundColor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Foregroundcolor"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"hidden": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Hidden"
}
},
"title": "CalendarSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"calendars": {
"items": {
"$ref": "#/$defs/CalendarSummary"
},
"title": "Calendars",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListCalendarsOutput",
"type": "object"
}
list_color_id_options — List available color ID options for events, with hex backgrounds.
list_color_id_options — List available color ID options for events, with hex backgrounds.
Response
{
"$defs": {
"ColorEntry": {
"additionalProperties": false,
"properties": {
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
}
},
"title": "ColorEntry",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"options": {
"items": {
"$ref": "#/$defs/ColorEntry"
},
"title": "Options",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListColorIdOptionsOutput",
"type": "object"
}
list_event_instances — List individual instances of a recurring event.
list_event_instances — List individual instances of a recurring event.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the recurring event.
integer
Maximum attendees per instance to include.
integer
Maximum number of instances to return across paged calls.
boolean
Include cancelled instances.
string
Lower bound (RFC3339) for instance start times.
string
Upper bound (RFC3339) for instance start times.
string
IANA time zone used in the response.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"instances": {
"items": {
"$ref": "#/$defs/EventSummary"
},
"title": "Instances",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListEventInstancesOutput",
"type": "object"
}
list_events — List events on a Google Calendar, with optional filters and pagination.
list_events — List events on a Google Calendar, with optional filters and pagination.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
Specifies an iCalendar UID to filter by.
integer
Maximum attendees per event to include.
integer
Maximum number of events to return across paged calls.
string
Sort order. One of: startTime, updated. startTime requires single_events=true.
string
propertyName=value constraint on private extended properties.
string
Free-text search across event fields.
string
propertyName=value constraint on shared extended properties.
boolean
Include cancelled events.
boolean
Include hidden invitations.
boolean
Expand recurring events into individual instances.
string
Upper bound (RFC3339) for event start times.
string
Lower bound (RFC3339) for event start times.
string
IANA time zone used in the response.
string
Lower bound (RFC3339) for event last-modified time.
array
Filter by event type. Values: default, focusTime, outOfOffice, workingLocation.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"events": {
"items": {
"$ref": "#/$defs/EventSummary"
},
"title": "Events",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListEventsOutput",
"type": "object"
}
query_free_busy_calendars — Query free/busy time blocks across one or more calendars over a date range.
query_free_busy_calendars — Query free/busy time blocks across one or more calendars over a date range.
Parameters
array
required
List of calendar IDs to query (use ‘primary’ for the user’s primary calendar). (Default:
["primary"])string
required
Start of the query window (RFC3339).
string
required
End of the query window (RFC3339).
string
IANA time zone for the response.
Response
{
"$defs": {
"FreeBusyCalendar": {
"additionalProperties": false,
"properties": {
"busy": {
"items": {
"$ref": "#/$defs/FreeBusyPeriod"
},
"title": "Busy",
"type": "array"
},
"errors": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Errors"
}
},
"title": "FreeBusyCalendar",
"type": "object"
},
"FreeBusyPeriod": {
"additionalProperties": false,
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
}
},
"title": "FreeBusyPeriod",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"timeMin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timemin"
},
"timeMax": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timemax"
},
"calendars": {
"additionalProperties": {
"$ref": "#/$defs/FreeBusyCalendar"
},
"title": "Calendars",
"type": "object"
}
},
"required": [
"success"
],
"title": "QueryFreeBusyCalendarsOutput",
"type": "object"
}
quick_add_event — Create an event from a natural-language string (Google parses date/time/title).
quick_add_event — Create an event from a natural-language string (Google parses date/time/title).
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
Natural-language event description, e.g. ‘Meet with Sarah at 3pm Friday’.
array
Optional list of attendee email addresses to add after parsing.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "QuickAddEventOutput",
"type": "object"
}
update_event — Update an existing event on a Google Calendar.
update_event — Update an existing event on a Google Calendar.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the event to update.
string
New event title.
string
New start (yyyy-mm-dd for all-day, or RFC3339 for timed).
string
New end (yyyy-mm-dd for all-day, or RFC3339 for timed).
string
New event location.
string
New event description.
array
Replacement list of attendee email addresses.
string
New color ID for the event.
string
IANA time zone (defaults to the event’s existing time zone).
string
Whether to send notifications. One of: all, externalOnly, none.
string
Updated recurrence frequency. One of: DAILY, WEEKLY, MONTHLY, YEARLY.
integer
Updated recurrence interval.
array
Two-letter day codes for WEEKLY recurrence.
string
New end date for recurrence (yyyy-mm-dd).
integer
New number of occurrences.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "UpdateEventOutput",
"type": "object"
}
update_event_instance — Update a single instance of a recurring event (changes apply only to that instance).
update_event_instance — Update a single instance of a recurring event (changes apply only to that instance).
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the specific recurring-event instance to update.
string
New event title.
string
New start (yyyy-mm-dd for all-day, or RFC3339 for timed).
string
New end (yyyy-mm-dd for all-day, or RFC3339 for timed).
string
New event location.
string
New event description.
array
Replacement list of attendee email addresses.
string
New color ID for the event instance.
string
IANA time zone (defaults to the instance’s existing time zone).
string
Whether to send notifications. One of: all, externalOnly, none.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"success"
],
"title": "UpdateEventInstanceOutput",
"type": "object"
}
update_following_instances — Update all instances of a recurring event from a given instance forward by splitting the series.
update_following_instances — Update all instances of a recurring event from a given instance forward by splitting the series.
Parameters
string
Calendar identifier (use ‘primary’ for the user’s primary calendar). (Default:
primary)string
required
ID of the parent recurring event.
string
required
ID of the instance from which the split begins (this and all following instances are updated).
string
New event title for the split series.
string
New start (yyyy-mm-dd or RFC3339) for the split series.
string
New end (yyyy-mm-dd or RFC3339) for the split series.
string
New location for the split series.
string
New description for the split series.
array
Replacement list of attendee email addresses.
string
New color ID for the split series.
string
IANA time zone for the split series.
string
Whether to send notifications. One of: all, externalOnly, none.
string
Optional new recurrence frequency for the split series.
integer
Optional new recurrence interval for the split series.
string
Optional new recurrence end date (yyyy-mm-dd).
integer
Optional new occurrence count.
Response
{
"$defs": {
"EventSummary": {
"additionalProperties": false,
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
},
"htmlLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Htmllink"
},
"created": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created"
},
"updated": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated"
},
"start": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"end": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"creator": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Creator"
},
"organizer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Organizer"
},
"attendees": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Attendees",
"type": "array"
},
"recurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurrence"
},
"recurringEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recurringeventid"
},
"visibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Visibility"
},
"colorId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Colorid"
},
"conferenceData": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Conferencedata"
},
"hangoutLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hangoutlink"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Etag"
},
"iCalUID": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Icaluid"
},
"sequence": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sequence"
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Eventtype"
}
},
"title": "EventSummary",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"originalEventId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Originaleventid"
},
"newEvent": {
"anyOf": [
{
"$ref": "#/$defs/EventSummary"
},
{
"type": "null"
}
],
"default": null
},
"trimmedRecurrence": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Trimmedrecurrence"
}
},
"required": [
"success"
],
"title": "UpdateFollowingInstancesOutput",
"type": "object"
}
Limits & Quotas
- Per-user default quota: ~1,000,000 queries/day; per-user per-100-seconds quota also applies (see Google Calendar API quotas).
- Quotas are shared across all Google Calendar API methods for the authenticated user.
list_eventsandlist_event_instancespage through results internally and honormax_resultsas a soft cap across pages.update_following_instancesperforms four sequential API calls (get original, get instance, delete instance, trim recurrence, create new event); on partial failure the deleted instance is restored automatically when possible. Network or quota errors mid-flow can leave the series in a manually-recoverable state.- Error model: non-2xx responses raise (Pattern A). The runtime surfaces them as failed tool calls; the agent decides whether to retry.