Skip to main content
The Google Calendar toolkit lets agents list and manage calendar events, create or update meetings, check free/busy availability, and list calendars the user can access. Authentication is per-user OAuth — each user connects their own Google account. Add it on the agent Toolkits tab. The first use prompts the user to connect Google if they have not already. Calendar shares the Google Workspace OAuth connection with Gmail, Drive, Docs, and related Google toolkits.

​
Prerequisites

  • A Google account with Calendar access
  • An agent you can edit
  • Google OAuth configured for your organization (admin)
  • Users who will chat with the agent must complete the Google OAuth connect flow when prompted

​
Setup

  1. Open the agent → Toolkits → add Google Calendar.
  2. Optionally enable or disable individual tools in toolkit config.
  3. Save the agent. In Chat, connect Google when prompted.
  4. @-mention Calendar tools in the personality prompt for scheduling and availability tasks.

​
Available tools

Most tools default to the primary calendar when no calendar ID is provided.

​
Use cases

  • Find open slots before proposing a meeting
  • Create or update events from chat with attendees and location
  • Summarize upcoming events in a date range
  • Confirm which calendars the signed-in user can access

​
Tips

  • Prefer RFC3339 timestamps (or date-only YYYY-MM-DD for all-day events).
  • Time zone: the toolkit uses the user’s Calendar timezone when times omit a zone; pass an explicit time zone only when needed.
  • Attendee emails must be valid; required and optional attendee lists must not overlap.
  • Access is limited to what the connected Google user can see on their calendars.
  • For Outlook calendar, use Microsoft Outlook.

​
Troubleshooting