Google Workspace ListEvents
CertifiedList Google Calendar events with filters
Google Workspace ListEvents
List Google Calendar events with filters
Retrieves events from a shared calendar using time range, keyword, and pagination filters. Defaults: singleEvents true (expands recurring), showDeleted false. orderBy supports startTime (requires singleEvents) or updated; maxResults up to 2500.
type: io.kestra.plugin.googleworkspace.calendar.ListEventsExamples
id: googleworkspace_calendar_list_events
namespace: company.team
tasks:
- id: list_events
type: io.kestra.plugin.googleworkspace.calendar.ListEvents
serviceAccount: "{{ secret('GCP_SERVICE_ACCOUNT_JSON') }}"
calendarId: team@company.com
timeMin: "2025-08-10T00:00:00Z"
timeMax: "2025-08-12T00:00:00Z"
q: "standup"
singleEvents: true
orderBy: startTime
showDeleted: false
maxResults: 100
Properties
calendarId *Requiredstring
Calendar ID
Email-style calendar shared with the service account, e.g. team@company.com
maxResults integerstring
Max results
Number of events per page (1–2500)
orderBy string
Order by
startTime (requires singleEvents=true) or updated
pageToken string
Page token
Pagination token from a previous response
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
q string
Keyword search
Free-text query across summary, description, and location
readTimeout integerstring
120The read timeout for the request (in seconds)
scopes array
["https://www.googleapis.com/auth/calendar"]The GCP scopes to used
serviceAccount string
The GCP service account key
showDeleted booleanstring
falseInclude cancelled
Whether to include cancelled events; default false
singleEvents booleanstring
trueReturn single instances
When true (default), expands recurring events
timeMax string
End time upper bound
RFC3339 timestamp for latest event end (timeMax)
timeMin string
Start time lower bound
RFC3339 timestamp for earliest event start (timeMin)
Outputs
events array
Matched events
io.kestra.plugin.googleworkspace.calendar.models.Event
metadataList array
Raw event metadata
nextPageToken string
Next page token
