GoogleCalendarToolkit

GoogleCalendarToolkit gives an agent a set of tools to work with your Google Calendar: look up events, create new ones and change existing ones. It also lets the agent know the current date and time, so it understands requests like “tomorrow at ten”. The agent decides when to use each tool during the conversation.

When to use it

• An assistant that books appointments with customers.
• Checking the week’s schedule and pointing out free slots.
• Moving a meeting to another time when someone asks.

Configuration

You need a Google Calendar credential, connected by signing in with your Google account. See Credentials.

Field	What it does
Credential (required)	The Google Calendar credential of the account whose calendar the agent uses.
Token String	No need to fill it in: access comes from the credential.
Scopes	No need to fill it in: permissions come from the credential.

Tools

Tool	What it does
get_current_datetime	Returns the current date and time in a time zone.
list_events	Lists calendar events, filtered by start date, end date and title.
create_new_event	Creates an event with a title, start and end, and optionally a location, description and guests.
update_exist_event	Changes an existing event: title, times, location, description or guests.

Output

The BaseToolkit output is the set of tools. Connect it to an agent’s tools connector.

Example

A clinic wants an assistant that books appointments.

1. Add GoogleCalendarToolkit with the Google Calendar credential of the clinic’s calendar.
2. Connect BaseToolkit to the agent.
3. In the agent’s instructions, state how long each appointment lasts and ask it to check with list_events that the slot is free before creating it.

Best practices

• State the time zone you work in in the agent’s instructions.
• To change an event, the agent has to find it first: ask it to search by date and title.
• The toolkit has no tool to delete events.

Related components

• Calendar Event: a single operation on events.
• Tool Mode: how an agent uses tools.