Skip to main content

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​

InputTypeDescription
runEventTriggers this operation.
timeMinDate/timeOptional lower boundary: matches events ending after this time. See the UTC precaution below.
timeMaxDate/timeOptional upper boundary: matches events starting before this time.
timeZoneTime zoneShown in the editor, but currently does not change how the range boundaries are interpreted. Use UTC for date-range filtering.
maxResultsNumberMaximum results in this request. Defaults to 100, capped at 2500.
queryTextOptional event search text.
calendarIdTextCalendar containing the event. Defaults to primary; use List Calendars to find another calendar’s id.

Properties​

SettingTypeDescription
connectionsConnectionSelect an authenticated Google Calendar connection from this project in the properties panel.

Outputs​

OutputTypeDescription
eventsDataArray of event objects, or an object with error on failure. Each event includes fields such as id, summary, start, end and attendees where available.
doneEventFires when the node returns, including when it returns an error result. Check the data output before continuing.

Time ranges and result limits​

Use UTC boundaries

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.

Project connections