# Google Calendar Integration

Give your AI agent the ability to read and manage events on Google Calendar.

---

Connect Google Calendar to your Chipp AI so it can list upcoming events, create new meetings, 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)
- Location
- Description
- Attendees with their RSVP status
- Direct link to the event in Google Calendar
- Event ID (for updates and deletions)

## Connecting Google Calendar


  **1.** 
    <strong>Open the Integrations tab</strong>

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


  **2.** 
    <strong>Click Connect</strong>

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


  **3.** 
    <strong>Authorize access</strong>

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

    > **Warning:** The integration requests full events access, which allows the AI to create, modify, and delete calendar events. Only connect accounts you trust the agent to manage.
  


  **4.** 
    <strong>Test it out</strong>

    Once connected, open the chat preview and try:
    - "What's on my calendar this week?"
    - "Schedule a team meeting for tomorrow at 2pm"
    - "Move the Friday standup 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 meetings do I have today?"
- "Show my calendar for next week"
- "List all events between March 1st and March 15th"

### Creating Events

Provide as much or as little detail as you want:

- "Schedule a 1-on-1 with Sarah tomorrow at 3pm for 30 minutes"
- "Create an all-day event called 'Company Retreat' on April 15th at the Hilton, and invite the whole team"
- "Block off Friday afternoon for deep work"

### Updating Events

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

- "Push the team meeting back by an hour"
- "Add the conference room as the location for tomorrow's standup"
- "Add john@example.com as an attendee to the project kickoff"

### 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.

## Example Use Cases

- **Scheduling assistant** -- "Schedule a 30-minute call with the client next Tuesday afternoon"
- **Daily briefing** -- "What's on my calendar today? Any conflicts?"
- **Meeting management** -- "Cancel all meetings on Friday and block it as a focus day"
- **Team coordination** -- "Create a weekly team sync every Monday at 9am with the engineering team"
- **Event lookup** -- "When is my next dentist appointment?"

## Billing

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