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

# Google Calendar

> Create events, check availability, and manage your schedule

Connect your Google account and unlock these capabilities: create and manage events, check free/busy availability, share
calendars, and give AI agents full read/write access to your schedule — all through a secure OAuth connection.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Event management" icon="calendar-plus">
    Create, update, and delete calendar events directly from chat or through an agent — no tab switching required.
  </Card>

  <Card title="Availability checks" icon="clock">
    Query free/busy slots across calendars to find open times for meetings, and quick-add events with natural language.
  </Card>

  <Card title="Calendar organization" icon="calendar-days">
    List, create, and manage multiple calendars, control sharing permissions, and configure settings.
  </Card>

  <Card title="15+ agent tools" icon="wrench">
    Choose actions for events, calendars, availability, sharing rules, and settings.
  </Card>
</CardGroup>

***

## Connect Google Calendar

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Google Calendar**.
  </Step>

  <Step title="Authorize with Google">
    Click **Connect** — you'll be redirected to Google's OAuth consent screen. Sign in with your Google account and
    grant calendar access.
  </Step>

  <Step title="Start using Google Calendar in agents">
    Open the agent and enable only the Calendar actions it needs. Access is limited by the connected Google account.
  </Step>
</Steps>

***

## Agent tools

Add Google Calendar tools to agents that need them. Their access is limited by the connected Google account and selected
tools.

### Events

| Tool            | Description                                                 |
| --------------- | ----------------------------------------------------------- |
| Create event    | Create a new calendar event with title, time, and attendees |
| Find event      | Search for events by keyword or date range                  |
| Get event       | Retrieve details of a specific event by ID                  |
| Update event    | Update an existing event's time, title, or attendees        |
| Delete event    | Remove an event from the calendar                           |
| Quick add       | Create an event from a natural-language string              |
| Move event      | Move an event to a different calendar                       |
| Remove attendee | Remove a specific attendee from an event                    |

### Availability

| Tool            | Description                                            |
| --------------- | ------------------------------------------------------ |
| Find free slots | Find available time slots across one or more calendars |
| Free/busy query | Query free/busy information for a set of calendars     |

### Calendars

| Tool               | Description                                        |
| ------------------ | -------------------------------------------------- |
| List calendars     | List all calendars the user has access to          |
| Get calendar       | Retrieve details of a specific calendar            |
| Update calendar    | Update calendar metadata like name and description |
| Duplicate calendar | Create a copy of an existing calendar              |

***

## Triggers

<Note>
  Triggers are not yet available for Google Calendar. Tools are fully supported — connect and start using them in any
  agent.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Schedule a meeting from chat">
    Ask your agent to find a free slot this afternoon and create a 30-minute meeting with specific attendees. The agent
    checks availability, creates the event, and confirms with a link — all without opening Google Calendar.
  </Accordion>

  <Accordion title="Get a daily schedule briefing">
    Ask your agent to pull today's events and summarize your schedule — meeting times, attendees, and gaps between calls
    — posted as a morning digest in your channel.
  </Accordion>

  <Accordion title="Auto-block focus time">
    Have your agent scan your calendar for the week, identify gaps longer than 2 hours, and create "Focus Time" blocks
    to protect your deep work hours.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth consent screen doesn't appear">
    Make sure pop-ups are not blocked in your browser. If the Google sign-in page doesn't open, try again with pop-ups
    allowed or use a different browser.
  </Accordion>

  <Accordion title="Agent can't see all my calendars">
    Only calendars visible to the authenticated Google account are accessible. Shared calendars must be added to your
    calendar list in Google Calendar first.
  </Accordion>

  <Accordion title="Events are created in the wrong calendar">
    By default, events are created on the primary calendar. Specify the target calendar ID when creating events to use a
    different one.
  </Accordion>

  <Accordion title="Authorization expired">
    Google OAuth tokens can expire. Go to **Settings → Integrations → Google Calendar**, disconnect, and reconnect to
    refresh your authorization.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>