List Events from All Calendars

TOOL

Slug

GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS

Version

20261010_00

Toolkit

googlecalendar

Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items`…

q

STRING

Free text search terms to find events that match these terms in any field, except for extended properties. Optional.

time_maxrequired

STRING

Upper bound (exclusive) for an event's start time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.

time_minrequired

STRING

Lower bound (inclusive) for an event's end time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.

event_types

ARRAY<STRING>

Event types to return. Optional.

calendar_ids

ARRAY<STRING>

Optional list of specific calendar IDs to query. If not provided, all calendars from the user's calendar list will be queried.

show_deleted

BOOLEAN

Whether to include deleted events (with status equals 'cancelled') in the result. Optional. The default is False.

Default: false

single_events

BOOLEAN

Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is True.

Default: true

response_detail

STRING

Level of detail in the response. 'minimal' (default) returns only the compact summary_view, omitting the large events array to reduce token usage. 'full' returns both summary_view and the full detailed events array.

Options: minimal, full

Default: "minimal"

max_results_per_calendar

INTEGER

Maximum number of events returned per calendar. Optional. If not provided, defaults to the API's default (250). Results may be paginated; follow `nextPageToken` in the response until absent to retrieve the complete event list.