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

# Connect Google Calendar

> One-click OAuth connect — grants every Voqo AI surface read access to your calendar.

Connecting Google Calendar is a one-click OAuth flow. You'll be redirected to Google to grant **read-only** access, then back to Voqo with a connected integration that every supported AI surface in the platform can use.

## Prerequisites

* **Workspace admin** role
* A **Google account** with access to the calendars you want Voqo's AI surfaces to use
* A browser session that can complete Google's OAuth consent screen (no blocker extensions)

## Connect

1. Open **Integrations** in the sidebar.
2. Find the **Google Calendar** card and click **Connect**.
3. You'll be redirected to Google. Sign in with the account that owns (or has access to) the calendars you want to use.
4. Review the permission Voqo is requesting (**See events on all your calendars**) and click **Allow**.
5. You'll be redirected back to Voqo. You'll see the scope picker with **Read Calendar** pre-selected.
6. Click **Confirm** to complete the connection.

The Google Calendar card now shows **Connected**. You can immediately start adding the calendar action to your voice agents — see [Add the calendar action to your voice agent](voice-agent-actions). Future AI surfaces in the platform (AI helper, SMS agent) will inherit this connection automatically as they ship.

## What permission Voqo asks for

| Permission                                       | Why we need it                                                                                                                                                                                                                                                                            |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **See events on all your calendars** (read-only) | Lets Voqo's AI surfaces read your calendar — busy/free windows plus event title, time, and location. Used by voice-agent availability checks during calls and by your AI assistant for questions like "what's on my plate today?". Voqo never reads your event attendees or descriptions. |

Voqo does **not** request permission to create, modify, or delete events. We also don't ask for any Gmail, Drive, or other Google data — only calendar read access.

<Note>
  **When we ship the calendar write capability** (booking events directly from a call), we'll prompt you to reconnect and grant the additional permission. You'll see exactly what's being asked for on Google's consent screen at that time.
</Note>

## What happens after you connect

* The integration card shows **Connected** with the email address you signed in as.
* The **Read Calendar** capability is now granted to your workspace. Every Voqo AI surface that supports it will see your calendar through this connection.
* Surfaces that use it today: the voice agent's **GCal — Check Availability** function-call action, and your **AI assistant** (which reads your events to answer scheduling questions).
* Coming surface: SMS agent.
* No background syncing happens. Voqo only reads your calendar when an AI surface actively needs it — nothing is cached or polled.

## Choose which calendars your AI assistant uses

By default, your AI assistant reads your **primary** calendar. To add others (or switch to a different one):

1. On the **Google Calendar** card, open the **⋮** menu and click **Choose calendars**.
2. Tick the calendars you want your AI assistant to read — your own calendars and any you've subscribed to both appear.
3. Click **Save**.

<Note>
  Calendars shared with you as **free/busy only** appear greyed out — your assistant can see when those are busy but not their event details, so they can't be added here.
</Note>

This selection is separate from the calendars each voice agent checks for availability, which are set per agent in the agent's settings.

## Reconnect

If your token expires, gets revoked at Google, or you sign in to a different Google account, you may need to reconnect:

1. Click **Reconnect** on the Google Calendar card.
2. Complete the OAuth flow again.

Your agent settings (which calendars to use, slot duration, etc.) are preserved across reconnects.

## Disconnect

1. Click **Disconnect** on the Google Calendar card.
2. If any of your voice agents use the **Check Availability** action, you'll see a confirmation listing those agents. Their Check Availability actions will be removed when you confirm.
3. Click **Disconnect** to confirm.

Disconnecting:

* Removes the integration from your workspace so no Voqo AI surface can use it.
* Removes the **Check Availability** function-call action from any voice agents that had it configured. You can re-add those actions after reconnecting.
* Stops every AI surface from using calendar capabilities on the next invocation (already-running calls finish normally).
* Does **not** read or change anything on your calendar — it's a read-only integration.

If you also want to revoke Voqo's access at Google itself (not just remove it from Voqo), use the **Revoking access at Google** steps below. If you change your mind, you can reconnect at any time.

## Revoking access at Google

You can also revoke Voqo's access directly from your Google account at any time, without going through Voqo:

1. Open [Google Account permissions](https://myaccount.google.com/permissions).
2. Find **Voqo** in the list.
3. Click **Remove access**.

If you revoke at Google, the next time a Voqo AI surface tries to use your calendar it will silently skip the lookup, and the integration card in Voqo will prompt you to reconnect.

## Related docs

* [Google Calendar Overview](overview)
* [Add the calendar action to your voice agent](voice-agent-actions)
* [Troubleshooting](troubleshooting)

## Need help?

If anything's not working as expected, contact <a href="mailto:support@voqo.ai?subject=Google%20Calendar%20setup%20help">support</a> with your workspace ID.