Get Event Instances

TOOL

Slug

GOOGLECALENDAR_EVENTS_INSTANCES

Version

20261010_00

Toolkit

googlecalendar

Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s)…

eventIdrequired

STRING

REQUIRED. The ID of the recurring event whose instances you want to retrieve. You must first use GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to find recurring events and get their IDs. This action only works with recurring events that have a recurrence rule.

timeMax

STRING

Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset.

timeMin

STRING

Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset.

timeZone

STRING

Time zone used in the response. Optional. The default is the time zone of the calendar.

pageToken

STRING

Token specifying which result page to return. Optional.

calendarIdrequired

STRING

Calendar identifier. To retrieve calendar IDs call the `calendarList.list` method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

maxResults

INTEGER

Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.

showDeleted

BOOLEAN

Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events will still be included if `singleEvents` is False. Optional. The default is False.

maxAttendees

INTEGER

The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.

originalStart

STRING

The original start time of the instance in the result. Optional.