Skip to main content
Connecting Google Calendar starts with a permissions step in Voqo, then an OAuth redirect to Google. You choose what to grant before you leave Voqo, and you land back on 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. On the Permissions step, review the two permissions Voqo requests. Read calendar is always granted. Create and manage events is ticked by default — untick it if you only want read access.
  4. Click Continue to Google. You’ll be redirected to Google. Sign in with the account that owns (or has access to) the calendars you want to use.
  5. Review the permission Google lists on its consent screen and click Allow.
  6. You’ll be redirected back to Voqo, on the Calendars step. Tick the calendars you want your AI assistant to read.
  7. Click Save & finish.
The Google Calendar card now shows Connected, and your AI assistant can use it straight away. You can also start adding the calendar action to your voice agents — see Add the calendar action to your voice agent. Surfaces still to come (the SMS agent) will inherit this connection automatically as they ship.

​
What permissions Voqo asks for

Voqo doesn’t ask for any Gmail, Drive, or other Google data — only calendar access.

​
What happens after you connect

  • The integration card shows Connected with the email address you signed in as.
  • Every Voqo AI surface that supports calendar reading can now see your calendar through this connection. If you kept Create and manage events ticked, your AI assistant can also change your calendar, and other booking surfaces will use the permission as they ship.
  • Surfaces that use it today: the voice agent’s GCal — Check Availability function-call action (reads only), and your AI assistant (reads your events to answer scheduling questions, and creates, reschedules, or cancels events when you ask — confirming with you first).
  • 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 reads

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.
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.
This selection controls reading, not writing. It’s the set of calendars your assistant looks at when you ask what’s on. When you ask it to create or change an event, it acts on the calendar you name in that request, which can be any calendar the connected Google account can write to. If you only want Voqo to read your calendar, untick Create and manage events during setup, or revoke access at Google.
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).
  • Voqo stops reading or changing anything on your calendar from the moment you disconnect.
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.
  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.

​
Need help?

If anything’s not working as expected, contact support with your workspace ID.