List calendar events
List events on the calendar of the caller’s connected account.
Reads the primary Google Calendar of a Gmail account or the default calendar
of an Outlook account. start/end select the events overlapping that
window; without them, Outlook returns recurring series as single entries, so
supply a window to expand them. title, location and attendees filter the
events that were read.
Authentication
Headers
Query parameters
Text filter. On Outlook this matches the event title only (contains(subject, …)); on Google Calendar it is Google's free-text event search (q), which also matches the description, location and attendee names.
Window start. start and end select events that overlap the window: an event that begins before start but is still running at start is included. ISO 8601 with an explicit UTC offset or Z (e.g. 2026-10-01T00:00:00-04:00); the instant is forwarded in RFC 3339 form. Recurring series are expanded into their instances inside the window. Given only one bound, Google leaves the other side open while Outlook derives it 60 days away.
Window end (see start); must be later than start when both are given. ISO 8601 with an explicit UTC offset or Z.
Only events whose location contains this text. Applied after up to limit events have been read from the provider, so narrow the window with start/end when looking for a specific event.
Only events with at least one of these attendee emails (comma-separated). Applied after up to limit events have been read from the provider, so narrow the window with start/end when looking for a specific event.
Maximum number of events (1-200).
Response
Account provider as Athena reports it: gmail or outlook for accounts connected through the Integrations page; google or microsoft365 for directly-connected accounts.