Google Calendar
Connects to the Google Calendar API for managing calendars and events. An agent can list calendars, browse and search events, and create or delete events.
Add to an agent node's tools array with _node_type: "tool-google-calendar". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes | OAuth2 access token for the Google Calendar API, sent as Authorization: Bearer <token>. Typically populated from a stored OAuth connection via oauth_connection_id. |
{
"name": "google_calendar",
"_node_type": "tool-google-calendar",
"oauth_connection_id": "{{ connections.google }}"
}
Tools
gcal_list_calendars
List all Google Calendars in the user's account.
No parameters.
Returns: A list of calendars as - **<summary>**[ (primary)] id: <id> lines, or "No calendars found.".
gcal_list_events
List upcoming events from a Google Calendar.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
calendar_id | string | Yes | Calendar ID (use primary for main calendar) |
time_min | string | No | Start time in RFC3339 format (e.g. 2024-01-01T00:00:00Z) |
time_max | string | No | End time in RFC3339 format |
max_results | number | No | Max events to return (default 10) |
Returns: A list of events as - **<summary>** (<start time>)[ @ <location>] id: <id> lines, ordered by start time, or "No events found.".
gcal_get_event
Get details of a specific Google Calendar event.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
calendar_id | string | Yes | Calendar ID |
event_id | string | Yes | Event ID |
Returns: A text block with the event title, start/end times, location, comma-separated attendee emails, and description.
gcal_create_event
Create a new event on a Google Calendar.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
calendar_id | string | Yes | Calendar ID (use primary for main) |
title | string | Yes | Event title |
start_time | string | Yes | Start time in RFC3339 (e.g. 2024-01-15T10:00:00-07:00) |
end_time | string | Yes | End time in RFC3339 |
description | string | No | Event description |
location | string | No | Event location |
attendees | string | No | Comma-separated email addresses of attendees |
timezone | string | No | Timezone (e.g. America/New_York, default UTC) |
Returns: A confirmation message with the event title, ID, and an htmlLink to view it.
gcal_delete_event
Delete an event from a Google Calendar.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
calendar_id | string | Yes | Calendar ID |
event_id | string | Yes | Event ID to delete |
Returns: "Event deleted.".
gcal_search_events
Search for events in a Google Calendar by keyword.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
calendar_id | string | Yes | Calendar ID |
query | string | Yes | Search query (searches title, description, location) |
max_results | number | No | Max results (default 10) |
Returns: A list of matching events as - **<summary>** (<start time>) id: <id> lines, or "No matching events found.".