Google Calendar
Google Calendar connector to list calendars, manage events, and check availability.
Tools
Ask an agent for what you need in plain language — it picks the right tool itself. You can also limit which of these an agent may use, and require your approval before any of them runs.
List the calendars on the account's calendar list.
| Parameter | Type | Description |
|---|---|---|
| maxResults | integer | — |
| pageToken | string | Token from a previous call to fetch the next page. |
List events from a Google Calendar within a time range, ordered by start time. Recurring events are expanded into individual instances.
| Parameter | Type | Description |
|---|---|---|
| calendarId | string | Calendar ID. Defaults to "primary" (the account's main calendar). |
| timeMin | string | Lower bound (RFC3339, e.g. "2026-07-06T00:00:00+02:00"). Events ending before this are excluded. |
| timeMax | string | Upper bound (RFC3339). Events starting after this are excluded. |
| query | string | Free-text search over event title, description, location, and attendees. |
| maxResults | integer | — |
| pageToken | string | Token from a previous call to fetch the next page. |
Get the full details of a single Google Calendar event.
| Parameter | Type | Description |
|---|---|---|
| eventIdrequired | string | ID of the event to fetch. |
| calendarId | string | Calendar ID. Defaults to "primary". |
Create an event in a Google Calendar, optionally inviting attendees.
| Parameter | Type | Description |
|---|---|---|
| calendarId | string | Calendar ID. Defaults to "primary". |
| summaryrequired | string | Event title. |
| description | string | Event description. Plain text or simple HTML. |
| location | string | — |
| startrequired | string | Start: RFC3339 datetime ("2026-07-06T10:00:00+02:00") or "YYYY-MM-DD" for an all-day event. |
| endrequired | string | End, same format as start. For all-day events the end date is exclusive. |
| timeZone | string | IANA time zone (e.g. "Europe/Bratislava") applied when start/end lack a UTC offset. |
| attendees | string[] | Email addresses to invite. |
| addGoogleMeet | boolean | Attach a Google Meet conference link. |
| recurrence | string[] | Recurrence rules, e.g. ["RRULE:FREQ=WEEKLY;BYDAY=MO"]. |
| sendUpdates | "all" | "externalOnly" | "none" | Whether Google emails invitations to attendees. Defaults to "none". |
Update fields of an existing Google Calendar event. Only the provided fields change.
| Parameter | Type | Description |
|---|---|---|
| eventIdrequired | string | ID of the event to update. For a recurring event, an instance ID updates that instance and the series ID updates the whole series. |
| calendarId | string | Calendar ID. Defaults to "primary". |
| summary | string | New event title. |
| description | string | New event description. |
| location | string | — |
| start | string | New start: RFC3339 datetime ("2026-07-06T10:00:00+02:00") or "YYYY-MM-DD" for an all-day event. Provide start and end together. |
| end | string | New end, same format as start. For all-day events the end date is exclusive. |
| timeZone | string | IANA time zone applied when start/end lack a UTC offset. |
| attendees | string[] | Replaces the full attendee list with these email addresses. |
| sendUpdates | "all" | "externalOnly" | "none" | Whether Google emails attendees about the change. Defaults to "none". |
Delete an event from a Google Calendar.
| Parameter | Type | Description |
|---|---|---|
| eventIdrequired | string | ID of the event to delete. For a recurring event, an instance ID deletes that instance and the series ID deletes the whole series. |
| calendarId | string | Calendar ID. Defaults to "primary". |
| sendUpdates | "all" | "externalOnly" | "none" | Whether Google emails attendees about the cancellation. Defaults to "none". |
Check free/busy availability for one or more calendars or attendees within a time window. Gaps between the returned busy intervals are free.
| Parameter | Type | Description |
|---|---|---|
| timeMinrequired | string | Start of the window to check (RFC3339, e.g. "2026-07-06T09:00:00+02:00"). |
| timeMaxrequired | string | End of the window to check (RFC3339). At most 3 months after the start. |
| calendarIds | string[] | Calendar IDs or attendee email addresses to check. Defaults to ["primary"]. |
| timeZone | string | IANA time zone for the returned busy intervals (e.g. "Europe/Bratislava"). |
Permissions
You choose what to grant on the provider's consent screen. A tool is only available to your agents if you granted the permission it needs, so granting less simply means fewer tools.
- https://www.googleapis.com/auth/calendar.events
- https://www.googleapis.com/auth/calendar.readonly