Google Calendar:List Events
Controlled node
Overview
Find events in a calendar by date range and search text.
Fetch events from a connected calendar. Recurring events are expanded into individual occurrences, and results are ordered by start time.
Inputs
| Input | Type | Description |
|---|---|---|
| run | Event | Triggers this operation. |
| timeMin | Date/time | Optional lower boundary: matches events ending after this time. See the UTC precaution below. |
| timeMax | Date/time | Optional upper boundary: matches events starting before this time. |
| timeZone | Time zone | Shown in the editor, but currently does not change how the range boundaries are interpreted. Use UTC for date-range filtering. |
| maxResults | Number | Maximum results in this request. Defaults to 100, capped at 2500. |
| query | Text | Optional event search text. |
| calendarId | Text | Calendar containing the event. Defaults to primary; use List Calendars to find another calendar’s id. |
Properties
| Setting | Type | Description |
|---|---|---|
| connections | Connection | Select an authenticated Google Calendar connection from this project in the properties panel. |
Outputs
| Output | Type | Description |
|---|---|---|
| events | Data | Array of event objects, or an object with error on failure. Each event includes fields such as id, summary, start, end and attendees where available. |
| done | Event | Fires when the node returns, including when it returns an error result. Check the data output before continuing. |
Time ranges and result limits
Currently, date-range boundaries are treated as UTC regardless of the selected time zone. Convert your intended range to UTC first and use UTC values, such as 2026-11-10T00:00:00Z. Do not supply a local time with an offset and expect it to be converted.
The node returns one page, not the full calendar. It does not expose a continuation token. Narrow the date range or search when results reach maxResults. All-day events use start.date/end.date; timed events use start.dateTime/end.dateTime.
Example
Select the connection and calendar, set a UTC range for the week you want, and trigger run. After checking events is an array, pass it to For Each → object, and connect done to the loop’s run. Use each event’s id for Get Event, Update Event or Respond to Event.