Integrate analytical data into your agent workflows to achieve superior business results. By connecting your agents with BigQuery, you can provide actionable insights directly to them. Move past standard analytics and utilize BigQuery's advanced features, such as forecasting, to generate higher-value intelligence.
batch_read_eventRead multiple Google Calendar events by ID.
event_idsarraycalendar_idstringCalendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.
nullcreate_eventCreate a new Google Calendar event and return its details.
If add_google_meet is true, Google may return a pending conference state before the Meet link is fully provisioned. Re-read the event later if you need finalized conference details.
attendeesarrayList of attendee emails to invite. The authenticated user's attendance is controlled by `self_attendance`. Pass an empty list for a solo status block. For `outOfOffice`, this must be an empty list.
end_timestringEvent end datetime in full ISO-8601/RFC3339 format (e.g. 2026-05-01T10:00:00-07:00).
start_timestringEvent start datetime in full ISO-8601/RFC3339 format (e.g. 2026-05-01T09:00:00-07:00).
titlestringadd_google_meetbooleanIf true, request a Google Meet link for the event. If conference creation is still pending, re-read the event later to check final Meet details.
nullauto_decline_modestringAuto-decline behavior for status events
nullchat_statusstringChat status for focus time events
nulldecline_messagestringOptional message sent when declining
nulldescriptionstringDescription of the event
nullevent_typestringOptional event type. Use `outOfOffice` or `focusTime` for status events. For a personal focus block, prefer `attendees=[]`; use `self_attendance="omit"` if you do not want the authenticated user added as an attendee. For `outOfOffice`, Google Calendar rejects events with attendees, so use `attendees=[]` and `self_attendance="omit"`.
nulllocationstringLocation of the event
nullrecurrencearrayOptional raw Google/RFC5545 recurrence lines (for example `RRULE:FREQ=WEEKLY;BYDAY=MO`). Omit for one-off events.
nullremindersEvent reminder configuration. Use the calendar defaults when omitted.
nullself_attendancestringHow the authenticated user should be represented on the event they create. Defaults to `accepted`; use `omit` to create the event without adding the authenticated user as an attendee. For `outOfOffice`, this must be `omit`. For a solo `focusTime` block, prefer `omit`.
accepteddeclinedtentativeomitacceptedtimezone_strstringIANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.
nulltransparencystringOptional event transparency. Use `opaque` to block the time as busy, or `transparent` to keep the event from blocking the calendar so overlapping bookings can still be scheduled. Leave null for Google default behavior.
nullvisibilitystringOptional event visibility (`default`, `public`, or `private`). Leave null for Google default behavior.
nulldelete_eventRemove a Google Calendar event.
event_idstringfetchGet details for a single Google Calendar event.
event_idstringget_availabilityLook up busy windows on one or more calendars before scheduling a meeting.
Use this action when the user wants availability for a coworker, room, or other known calendar ID. time_min and time_max must be full RFC3339 datetimes with Z or an explicit UTC offset. response_timezone_str controls only how Google formats the busy window timestamps in the response. This action returns busy windows only, not event titles or details, and inaccessible calendars are reported as per-calendar errors.
calendar_idsarrayList of calendar IDs to query. Use Google Calendar IDs such as `primary`, a coworker email, or a room/resource email.
response_timezone_strstringRequired IANA timezone name used for response timestamps only, such as `America/Los_Angeles` or `Europe/Berlin`. This does not define the query interval.
time_maxstringRequired RFC3339 datetime string with `Z` or an explicit UTC offset (for example `2026-05-01T10:00:00-07:00`). Do not pass naive datetimes and do not pass `now`.
time_minstringRequired RFC3339 datetime string with `Z` or an explicit UTC offset (for example `2026-05-01T09:00:00-07:00`). Do not pass naive datetimes and do not pass `now`.
get_profileReturn the current Google Calendar user's profile information.
This action takes no parameters.
read_eventRead a Google Calendar event by ID.
event_idstringGoogle Calendar event ID, typically from search results.
calendar_idstringCalendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.
nullread_event_all_fieldsRead a Google Calendar event with extended Google metadata by ID.
event_idstringGoogle Calendar event ID, typically from search results.
calendar_idstringCalendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.
nullrespond_eventRespond to a Google Calendar event invitation.
event_idstringresponse_statusstringYour response to the event invitation
accepteddeclinedtentativenotifybooleanNotify attendees of this response
FalsereasonstringOptional note explaining your response
nullsearchSearch Google Calendar events within an optional time window.
Accepted parameters are only query, max_results, time_min, and time_max. query is broad free text, not a structured search language. Do not pass unsupported fields like topn, timezone_str, calendar_id, user_message, or best_effort_fetch.
querystringBroad free-text search over event titles plus some Google-indexed text fields such as descriptions, locations, and some email fields. Reliable for event titles and some email matches, but do not rely on this as a precise attendee-name filter.
max_resultsintegerMaximum number of events to return. Must be at least 1.
50time_maxstringOptional window end in full ISO-8601/RFC3339 format (e.g. 2026-05-31T23:59:59Z).
nulltime_minstringOptional window start in full ISO-8601/RFC3339 format (e.g. 2026-05-01T00:00:00Z).
nullsearch_eventsLook up Google Calendar events using various filters.
query is broad free text, not a structured search language.
calendar_idstringCalendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.
nullmax_resultsintegerMaximum number of events to return. Must be at least 1.
50next_page_tokenstringPagination token returned by a previous search_events/search_events_all_fields call. Omit on the first page.
nullquerystringBroad free-text search over event titles plus some Google-indexed text fields such as descriptions, locations, and some email fields. Do not rely on this as a precise attendee-name filter.
nulltime_maxstringEnd of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-31T23:59:59Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.
nulltime_minstringStart of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-01T00:00:00Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.
nulltimezone_strstringTimezone for interpreting time_min/time_max. IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.
nullsearch_events_all_fieldsLook up Google Calendar events with extended Google metadata.
calendar_idstringCalendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.
nullmax_resultsintegerMaximum number of events to return. Must be at least 1.
50next_page_tokenstringPagination token returned by a previous search_events/search_events_all_fields call. Omit on the first page.
nullquerystringnulltime_maxstringEnd of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-31T23:59:59Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.
nulltime_minstringStart of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-01T00:00:00Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.
nulltimezone_strstringTimezone for interpreting time_min/time_max. IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.
nullupdate_eventUpdate an existing Google Calendar event.
If add_google_meet is true, Google may return a pending conference state before the Meet link is fully provisioned. Re-read the event later if you need finalized conference details.
event_idstringGoogle Calendar event ID, typically from search results.
add_google_meetbooleanIf true, request a Google Meet link for the event. If conference creation is still pending, re-read the event later to check final Meet details.
nullattendeesarrayList of emails of the attendees. Add 'me' to add the current user as an attendee. Leave null or empty to keep the same attendees.
nullattendees_to_addarrayList of attendee email addresses to add to the event. Each entry must be an email address or `me`. Omit or pass an empty list to leave additions unchanged.
nullattendees_to_removearrayList of attendee email addresses to remove from the event. Each entry must be an email address or `me`. Omit or pass an empty list to leave removals unchanged.
nullauto_decline_modestringAuto-decline behavior for status events
nullchat_statusstringChat status for focus time events
nulldecline_messagestringOptional message sent when declining
nulldescriptionstringDescription of the event. Leave null to keep the same description.
nullend_timestringNew end datetime in full ISO-8601/RFC3339 format. Leave null to keep the same end time.
nullevent_typestringType for status events (`focusTime`/`outOfOffice`). Google Calendar does not allow changing an existing event's eventType.
nulllocationstringLocation of the event. Leave null to keep the same location.
nullrecurrencearrayNew raw Google/RFC5545 recurrence lines. Only valid for `entire_series` or `this_and_following`. Omit to leave recurrence unchanged. For `this_and_following`, omitting recurrence reuses the current series rule from the split point onward unless the original rule is COUNT-based.
nullremindersReminder configuration. Omit to keep existing reminders.
nullstart_timestringNew start datetime in full ISO-8601/RFC3339 format. Leave null to keep the same start time.
nulltimezone_strstringIANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Provide this whenever changing start_time and/or end_time.
nulltitlestringTitle of the event. Leave null to keep the same title.
nulltransparencystringOptional event transparency. Use `opaque` to block the time as busy, or `transparent` to keep the event from blocking the calendar so overlapping bookings can still be scheduled. Leave null to keep existing transparency unchanged.
nullupdate_scopestringHow to apply this update to a recurring event. Use `this_instance` to update only the selected occurrence, `entire_series` to update the recurring series master and apply the change to the whole recurring series, or `this_and_following` to split the recurring series at the selected occurrence and apply changes from there onward. For non-recurring events, `entire_series` behaves the same as `this_instance`.
this_instanceentire_seriesthis_and_followingthis_instancevisibilitystringOptional event visibility (`default`, `public`, or `private`). Leave null to keep existing visibility unchanged.
null