Google Calendar
Manage Google Calendar events from the agent.
Google Calendar
Lets the agent find, create, update and delete events in Google Calendar. It requires a Google Calendar connection configured in the workspace.
The available operations
When you add this tool, choose which operations the agent is allowed to perform.
Find events
Searches the calendar for events by text and date filters.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Query | Yes | — | The text to search for in the events (title, description, location and so on) |
| Calendar ID | No | primary | The calendar to search. Use primary for the main one |
| Minimum date/time | No | — | The lower date bound. ISO 8601 (e.g. 2024-01-01T00:00:00Z) |
| Maximum date/time | No | — | The upper date bound. ISO 8601 (e.g. 2024-12-31T23:59:59Z) |
| Maximum results | No | 10 | How many events to return at most |
Get an event
Returns one event's full details by its ID.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Event ID | Yes | — | The unique ID of the event |
| Calendar ID | No | primary | The calendar holding the event |
Create an event
Creates a new event in the calendar.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Calendar ID | No | primary | The calendar to create it in |
| Title | Yes | — | The event's title |
| Description | No | — | The event's description |
| Location | No | — | The event's location |
| Start (date/time) | Yes* | — | The start date and time, ISO 8601 (e.g. 2024-06-01T10:00:00-03:00). For timed events |
| Start (date) | No | — | The start date for all-day events, YYYY-MM-DD. Use instead of "Start (date/time)" |
| End (date/time) | No | — | The end date and time, ISO 8601 |
| End (date) | No | — | The end date for all-day events, YYYY-MM-DD |
| Time zone | No | UTC | The event's time zone (e.g. America/Sao_Paulo) |
| Attendees | No | — | The list of attendees. Each item needs email (string) and, optionally, optional (boolean) — true for optional attendance, false (the default) for required |
| Notifications | No | none | Who gets an email invitation: all, externalOnly or none |
*Give "Start (date/time)" for a timed event, or "Start (date)" for an all-day one — not both.
Update an event
Updates the fields of an existing event. Only the fields you give are changed.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Calendar ID | No | primary | The calendar holding the event |
| Event ID | Yes | — | The unique ID of the event to update |
| Title | No | — | The event's new title |
| Description | No | — | The event's new description |
| Location | No | — | The event's new location |
| Start (date/time) | No | — | The new start date and time, ISO 8601 |
| Start (date) | No | — | The new start date for an all-day event, YYYY-MM-DD |
| End (date/time) | No | — | The new end date and time, ISO 8601 |
| End (date) | No | — | The new end date for an all-day event, YYYY-MM-DD |
| Time zone | No | UTC | The event's time zone |
| Attendees | No | — | The new list of attendees. Each item needs email (string) and, optionally, optional (boolean) |
| Notifications | No | none | Who is notified of the update: all, externalOnly or none |
Delete an event
Removes an event from the calendar.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Calendar ID | No | primary | The calendar holding the event |
| Event ID | Yes | — | The unique ID of the event to delete |
| Notifications | No | none | Who is notified of the cancellation: all, externalOnly or none |