Skip to main content
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. Future AI surfaces in the platform (AI helper, SMS agent) will inherit this connection automatically as they ship.

​
What permission Voqo asks for

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

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