# Google Calendar Integration

Site visits, commissioning windows, dispatch scheduling. Connect AVCodex to Google Calendar and the agent reads, books, moves, and cancels jobs through natural language.

---

Connect Google Calendar to your AVCodex agent so it can list upcoming events, create new site visits or commissioning windows, update existing events, and delete cancelled ones, all through natural conversation.

## What the AI Can Do

Once connected, your agent gains four tools:

| Tool | Description |
|------|-------------|
| **google_calendar_list_events** | List upcoming events with titles, times, locations, and attendees |
| **google_calendar_create_event** | Create a new event with title, time, location, description, and attendees |
| **google_calendar_update_event** | Update an existing event (any field can be changed individually) |
| **google_calendar_delete_event** | Delete an event by its event ID |

### Event Details

Each event returned by the agent includes:

- Event title
- Start and end time (supports both date-time and all-day events, useful for multi-day commissioning)
- Location (the client site, the rack room, the headend)
- Description
- Attendees with their RSVP status
- Direct link to the event in Google Calendar
- Event ID (for updates and deletions)

## Connecting Google Calendar

  **1.**
    **Open the Integrations tab**

    In your agent's builder, navigate to the **Build** section and select the **Integrations** tab. Find **Google Calendar** in the list of available integrations.

  **2.**
    **Click Connect**

    Click the **Connect** button next to Google Calendar. A Google OAuth popup will appear.

  **3.**
    **Authorize access**

    Sign in with your Google account and grant the requested calendar events permission.

    > **Warning:** The integration requests full events access, which allows the agent to create, modify, and delete calendar events. Only connect accounts you trust the agent to manage. (Dispatch's calendar is fair game. The owner's personal calendar, probably not.)

  **4.**
    **Test it out**

    Once connected, open the chat preview and try:
    - "What site visits are on my calendar this week?"
    - "Schedule the Acme HQ commissioning kickoff for tomorrow at 8am"
    - "Move the Friday Q-SYS commissioning window to 10am"

## How It Works

### Listing Events

By default, the agent lists events for the next 7 days on the primary calendar. You can ask for different time ranges:

- "What jobs do I have today?"
- "Show my calendar for next week"
- "List all site visits between March 1st and March 15th"

### Creating Events

Provide as much or as little detail as you want:

- "Schedule a 1-hour site walk with Sarah at Acme HQ tomorrow at 3pm"
- "Create an all-day event called 'Acme HQ Commissioning Day 1' on April 15th at the Hilton conference center, and invite the whole field team"
- "Block off Friday afternoon for live-event support"

### Updating Events

Change any aspect of an event by describing what you want:

- "Push the Q-SYS commissioning window back by an hour"
- "Add Boardroom 4 as the location for tomorrow's site visit"
- "Add the Crestron rep, john@crestrondealer.com, as an attendee to the design review"

### Multiple Calendars

The integration defaults to the primary calendar, but can work with any calendar the connected account has access to by specifying a calendar ID. Most AV firms keep separate calendars for dispatch, programmers, and the project manager pool.

## Example Use Cases

- **Dispatch scheduling**: "Schedule a 30-minute truck roll for Acme HQ Boardroom 4 next Tuesday afternoon"
- **Daily briefing**: "What's on my calendar today? Any commissioning conflicts?"
- **Schedule cleanup**: "Cancel all internal meetings on Friday, the courtroom go-live needs full focus"
- **Recurring events**: "Create a weekly dispatch sync every Monday at 9am with the field ops team"
- **Job lookup**: "When is the next site visit at Acme HQ?"

## Billing

Google Calendar tool calls use your standard LLM token billing. There is no separate per-call fee.

*AVCodex · Your AV expertise. Amplified by AI.*