> ## Documentation Index
> Fetch the complete documentation index at: https://info.invictai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar Tools

Calendar tools allow AI Agents to interact with calendar services, enabling them to create and look up calendar events across different platforms.

<Note>
  Integrations required. [Learn how to set up.](/how-to/integration-setup)
</Note>

## Available Tools

| Tool Name    | Platform         | Description                             |
| ------------ | ---------------- | --------------------------------------- |
| Create Event | Google Calendar  | Creates new events in Google Calendar   |
| Find Events  | Google Calendar  | Searches for events in Google Calendar  |
| Create Event | Outlook Calendar | Creates new events in Outlook Calendar  |
| Find Events  | Outlook Calendar | Searches for events in Outlook Calendar |

## Google Calendar Tools

### Create Event

#### Description

Creates a new event in Google Calendar with specified details including time, location, attendees, and other event information.

#### System Tool ID and Tool Description for Agents

* **Tool ID**: `google_calendar_create_event`
* **Description**: Create event on Google Calendar.

#### Arguments

| Name              | Required                  | Type           | Description                                      |
| ----------------- | ------------------------- | -------------- | ------------------------------------------------ |
| start             | Required                  | string         | The event start time (RFC3339 format)            |
| end               | Required                  | string         | The event end time (RFC3339 format)              |
| location          | Optional                  | string         | The event location                               |
| attendees\_emails | Optional                  | array\[string] | List of attendee email addresses                 |
| timezone          | Optional (default: "utc") | string         | Time zone in IANA format (e.g., "Europe/Zurich") |
| summary           | Optional                  | string         | Event title/summary                              |
| description       | Optional                  | string         | Event description                                |

### Find Events

#### Description

Searches for events in 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

| Name      | Required | Type   | Description                                       |
| --------- | -------- | ------ | ------------------------------------------------- |
| time\_min | Optional | string | Lower bound for event end time (RFC3339 format)   |
| time\_max | Optional | string | Upper bound for event start time (RFC3339 format) |

## Outlook Calendar Tools

### Create Event

#### Description

Creates a new event in Outlook Calendar with specified details including time, location, attendees, and other event information.

#### System Tool ID and Tool Description for Agents

* **Tool ID**: `outlook_calendar_create_event`
* **Description**: Create event on Outlook Calendar.

#### Arguments

| Name              | Required                  | Type           | Description                                      |
| ----------------- | ------------------------- | -------------- | ------------------------------------------------ |
| start             | Required                  | string         | The event start time (RFC3339 format)            |
| end               | Required                  | string         | The event end time (RFC3339 format)              |
| location          | Optional                  | string         | The event location                               |
| attendees\_emails | Optional                  | array\[string] | List of attendee email addresses                 |
| timezone          | Optional (default: "utc") | string         | Time zone in IANA format (e.g., "Europe/Zurich") |
| subject           | Optional                  | string         | Event subject/title                              |
| body              | Optional                  | string         | Event body/description                           |

### Find Events

#### Description

Searches for events in 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

| Name        | Required | Type   | Description                              |
| ----------- | -------- | ------ | ---------------------------------------- |
| start\_time | Required | string | Event start time filter (RFC3339 format) |
| end\_time   | Required | string | Event end time filter (RFC3339 format)   |

<Tip>
  All date-time values must be in RFC3339 format (e.g., "2011-06-03T10:00:00Z"
  or "2011-06-03T10:00:00-07:00")
</Tip>

<Warning>
  When specifying time ranges, ensure that the end time is always greater than
  the start time.
</Warning>