Nodal-Agents
ReferenceConnectors

Google Calendar

Google Calendar connector — OAuth flow — uses your Google credential (create one under Credentials).

Auth: OAuth 2.0 (credential type google-oauth)

Slug: google-calendar

Setup: OAuth flow — uses your Google credential (create one under Credentials).

Access requested

Grants event access on your calendars (create, edit, delete events) and the ability to list them. It cannot create or delete calendars themselves.

OAuth scopes:

  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.calendarlist.readonly
  • https://www.googleapis.com/auth/calendar.freebusy
  • https://www.googleapis.com/auth/userinfo.email
  • openid

Destructive operations (delete, overwrite) can be disabled per-agent: in the agent's Connectors tab, the "enabled operations" allowlist controls exactly which of the tools below an agent may call. Operations marked Destructive below are the ones to review first.

Tools (7)

Read (4)

ToolOperationDescription
gcal_list_calendarsList calendarsList the calendars the user has access to.
gcal_list_eventsList eventsList events on a calendar within a time range (defaults to upcoming).
gcal_get_eventGet eventRetrieve a single event by ID.
gcal_find_free_slotsFind free slotsQuery busy/free intervals across calendars for scheduling.

Write (2)

ToolOperationDescription
gcal_create_eventCreate eventCreate a new calendar event (optionally inviting attendees).
gcal_update_eventUpdate eventUpdate an existing calendar event.

Destructive (1)

ToolOperationDescription
gcal_delete_eventDelete eventPermanently delete a calendar event.

On this page