Calendar Tools are a set of utilities that enable AI Agents to interact with Google Calendar and Outlook Calendar. These tools allow agents to find events and create new events in these calendar systems.

List of Calendar Tools

Tool NameDescription
Google Calendar Find EventsRetrieves a list of events from Google Calendar
Google Calendar Create EventCreates a new event in Google Calendar
Outlook Calendar Find EventsRetrieves a list of events from Outlook Calendar
Outlook Calendar Create EventCreates a new event in Outlook Calendar

Google Calendar Find Events

Description

This tool allows AI Agents to search for and retrieve a list of events from a user’s Google Calendar within a specified time range.

System Tool ID and Tool Description for Agents

  • Tool ID: google_calendar_find_events
  • Description: Find list of events from Google Calendar.

Arguments

NameRequiredTypeDescription
time_minOptionalStringLower bound (exclusive) for an event’s end time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset, e.g., “2011-06-03T10:00:00-07:00” or “2011-06-03T10:00:00Z”. If timeMax is set, timeMin must be smaller than timeMax.
time_maxOptionalStringUpper bound (exclusive) for an event’s start time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset, e.g., “2011-06-03T10:00:00-07:00” or “2011-06-03T10:00:00Z”. If timeMin is set, timeMax must be greater than timeMin.

If neither time_min nor time_max is specified, the tool will return events based on the default time range set by the Google Calendar API.

Google Calendar Create Event

Description

This tool enables AI Agents to create new events in a user’s Google Calendar with specified details such as time, location, attendees, and description.

System Tool ID and Tool Description for Agents

  • Tool ID: google_calendar_create_event
  • Description: Create event on Google Calendar.

Arguments

NameRequiredTypeDescription
startRequiredStringThe start time of the event, formatted as an RFC3339 timestamp.
endRequiredStringThe end time of the event, formatted as an RFC3339 timestamp.
timezoneOptionalStringThe time zone for the event. Default is “utc”. Use IANA Time Zone Database names, e.g., “Europe/Zurich”.
locationOptionalStringThe location of the event.
attendees_emailsOptionalArray of StringsEmail addresses of event attendees. Default is an empty array.
summaryOptionalStringA brief summary or title of the event.
descriptionOptionalStringA detailed description of the event.

Outlook Calendar Find Events

Description

This tool allows AI Agents to search for and retrieve a list of events from a user’s Outlook Calendar within a specified time range.

System Tool ID and Tool Description for Agents

  • Tool ID: outlook_calendar_find_events
  • Description: Find list of events from Outlook Calendar.

Arguments

NameRequiredTypeDescription
start_timeRequiredStringEvent’s start time to filter by. Must be an RFC3339 timestamp, e.g., “2011-06-03T10:00:00Z”.
end_timeRequiredStringEvent’s end time to filter by. Must be an RFC3339 timestamp, e.g., “2011-06-03T10:00:00Z”. Must be greater than start_time.

Outlook Calendar Create Event

Description

This tool enables AI Agents to create new events in a user’s Outlook Calendar with specified details such as time, location, attendees, and description.

System Tool ID and Tool Description for Agents

  • Tool ID: outlook_calendar_create_event
  • Description: Create event on Outlook Calendar.

Arguments

NameRequiredTypeDescription
startRequiredStringThe start time of the event, formatted as an RFC3339 timestamp.
endRequiredStringThe end time of the event, formatted as an RFC3339 timestamp.
timezoneOptionalStringThe time zone for the event. Default is “utc”. Use IANA Time Zone Database names, e.g., “Europe/Zurich”.
locationOptionalStringThe location of the event.
attendees_emailsOptionalArray of StringsEmail addresses of event attendees. Default is an empty array.
subjectOptionalStringThe subject or title of the event.
bodyOptionalStringThe body or description of the event.