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

# Google Calendar Overview

> Connect Google Calendar once and give every Voqo AI surface read access to your calendar — voice agent and AI assistant today, SMS coming.

Connecting Google Calendar gives Voqo's AI surfaces **read-only access to your calendar** — your busy/free windows plus your event titles, times, and locations — so the AI assistants you use across the platform can answer scheduling questions and check when you're free, all from the same one-click connection.

You connect Google Calendar once at the workspace level. Every Voqo feature that needs to know "are you free at X?" can then use that connection without you having to set anything up a second time.

<Note>
  **Booking events directly to your calendar is coming soon.** For now, the integration is read-only. When write capabilities ship, we'll prompt you to reconnect and grant the additional permission.
</Note>

## What can use this connection

| Feature                                                                                             | Status                | What it does with your calendar                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [**Voice agent — Check Availability**](../../agent-settings/function-calls#gcal-check-availability) | Available now         | During a call, the agent reads your calendar(s) and offers concrete open slots back to the caller. Added per agent as a [function-call action](../../agent-settings/function-calls#gcal-check-availability). |
| **AI assistant "what's on my plate"**                                                               | Available now         | The AgentOS sidebar assistant reads your events to answer questions like "what's on my plate today?" or "what does my afternoon look like?"                                                                  |
| **SMS agent — Check Availability**                                                                  | Coming with SMS agent | The SMS agent reuses the same Check Availability action to offer slots over text                                                                                                                             |

All three use the same Google Calendar connection — you grant permission once and every feature inherits it as it ships. Both the voice action and the AI assistant let you point Voqo at **multiple calendars** — your own plus any shared or subscribed ones — and each keeps its own selection (per agent for the voice action; workspace-level for the AI assistant).

## What this is good for

* **Inspection requests on a call.** Caller asks "when can I come and see the property?" — your voice agent reads back three open slots from your diary.
* **Quick "what's on today?" questions outside a call.** Ask your AI assistant directly and get an answer without opening your calendar.
* **Internal handovers.** A buyer asks for a callback from a sales colleague — your agent checks the colleague's calendar (if you've shared it with the connected Google account) and proposes times.

## What it isn't (yet)

* It doesn't write events to your calendar. Bookings are still a manual step for your team after the call.
* It doesn't read your event **attendees or descriptions** — only the title, time, and location of each event (plus busy/free windows). Those higher-sensitivity fields stay private.
* It doesn't sync your calendar into Voqo's database. Voqo reads your calendar **live** when an AI surface needs it. Nothing is cached or polled in the background.
* It only connects to Google Calendar — Outlook and Apple Calendar aren't supported yet.

## How it works

1. You connect your Google account once from the Integrations page.
2. The connection grants Voqo a single capability — **Read Calendar** — that every supported AI surface can use.
3. You configure each consumer — add the Check Availability action to your voice agent, and choose which calendars your AI assistant reads from the integration card's **⋮ → Choose calendars** menu.
4. Voqo reads from your calendar live whenever a consumer needs it. Nothing is stored on our side.

## What you'll need

* **Workspace admin** role to connect the integration.
* A **Google account** with access to the calendars you want Voqo's AI surfaces to use.

## Next steps

* [Setup and connect Google Calendar](setup)
* [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%20integration%20help">support</a> with your workspace ID.