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

# Google Calendar Integration

> Connect your Google Calendar account and instruct your AI Voice Agent to check availability and book appointments live on calls.

Your AI Voice Agent can check live calendar availability, book demos and meetings with Google Meet links, check existing bookings, and reschedule or cancel events during live phone calls.

***

## 1. Connect Your Google Account

To connect your Google Calendar to a specific AI Voice Agent:

1. Open your AI Voice Agent from **Your Custom Agents** in the left menu.
2. Click on the **Integrations** tab inside the agent.
3. You will see the **Google Calendar** integration card.
4. Click **Authorize** to begin the connection.
5. A secure popup window will open — select your Google account and grant calendar permissions.
6. Once authorized, the card will show **Connected** along with your Google email address.

<Note>
  **Agent-Specific Connections**: Each AI Voice Agent has its own dedicated calendar connection. You can connect different Google accounts to different agents in your workspace.
</Note>

***

## 2. Using Google Calendar in System Instructions

Once connected, activate the calendar tools by mentioning them in your agent's **System Instructions Script**.

### Trigger Keywords

The AI Agent automatically equips Google Calendar tools whenever your **System Instructions Script** includes keywords like:

* `google calendar`
* `get_availability`
* `create_event`
* `check_existing_events`
* `calendar tool`

### Available Calendar Tools

| Tool Name               | What It Does                                                                                         |
| ----------------------- | ---------------------------------------------------------------------------------------------------- |
| `get_availability`      | Queries free/busy slots on your Google Calendar before offering a time to the caller.                |
| `create_event`          | Creates a new event/appointment with an optional Google Meet link and sends an invite to the caller. |
| `check_existing_events` | Lists existing events on a specific date or time range to verify bookings.                           |
| `cancel_event`          | Cancels/deletes an existing event from your calendar.                                                |
| `reschedule_event`      | Moves an existing event to a new date and time.                                                      |

***

## 3. Example System Prompt Instructions

Once your Google Calendar is connected via the **Integrations** tab, add these instructions to your agent's **System Instructions Script**:

```markdown theme={null}
# APPOINTMENT & DEMO BOOKING INSTRUCTIONS:
- You have access to Google Calendar tools (`get_availability`, `create_event`).
- When the caller asks to book a demo or appointment:
  1. Ask for their preferred date and time.
  2. Call `get_availability` to check if the slot is free.
  3. If the slot is busy or daily booking limit is reached, inform the caller and offer an alternative slot.
  4. Once a time is agreed, ask for their name and email address.
  5. Call `create_event` with the agreed start time, end time, summary (e.g., "Demo with [Caller Name]"), and attendee email.
  6. Confirm to the caller that the invitation and Google Meet link have been sent to their email.
```

***

## 4. Timezone & Scheduling Rules

* **Default Timezone**: All dates and times spoken during calls or passed to calendar tools are evaluated in **Indian Standard Time (IST, Asia/Kolkata, UTC+05:30)** by default.
* **Daily Booking Limits**: If a daily booking limit is set for your agent, `get_availability` and `create_event` will automatically enforce it and prevent overbooking on any given date.

***

## 5. Disconnecting or Switching Accounts

To disconnect or switch the connected Google Calendar account:

1. Go to the **Integrations** tab for that agent.
2. Click **Disconnect** on the Google Calendar card.
3. Click **Authorize** again to connect a different Google account.
