Skip to main content
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Connect Google Calendar so your voice agents can check availability and book real appointments while a caller is still on the line. Once connected, every agent on your account can use the calendar — no per-agent re-authorization needed.

Available on every plan

Google Calendar is available on all plans including Free. No extra fee — calendar lookups and event creation use a few words of LLM output per turn, billed at your normal per-minute rate.

What It Does​

  • Availability checks — the agent reads your calendar to confirm whether a requested slot is free.
  • Event creation — the agent books a confirmed appointment as a new calendar event, with the caller's name, phone, and any notes captured during the call.
  • Cancellation links — every booking includes a self-service cancel link the caller receives by email or SMS, so they can change plans without calling back.

The agent does not read other people's event details, edit unrelated events, or expose calendar contents — only the slots it needs to answer the caller.

Connecting Your Google Account​

  1. Open Integrations in the sidebar and click Connect Google Calendar.
  2. You're redirected to Google's standard consent screen.
  3. Sign in with the Google account that owns the calendar you want to use.
  4. Review the requested permission — View and edit events on your calendars — and click Allow.
  5. You're returned to HANC and the integration card shows Connected with the email address used.

Scope requested​

HANC requests a single OAuth scope: https://www.googleapis.com/auth/calendar.events.

This is a Sensitive scope (not Restricted), which means:

  • HANC can read and create events, but cannot read your full calendar list, share settings, or access any other Google service (no Gmail, no Drive, no contacts).
  • Google does not require a Security Assessment for this scope, and there's no annual re-verification.

Account-wide, not per-agent​

The connection lives at the HANC account level. Tokens are stored once in a shared store and made available to every voice agent in your account. You authorise once and then enable the calendar tool on as many agents as you like.

This is different from per-agent settings like prompt, knowledge base, or voice — those are configured separately on each agent.

Per-Agent Tool Configuration​

Connecting Google to your HANC account makes the tool available. To actually use it, add the Google Calendar tool to the agent's Actions tab and configure it.

SettingWhat it does
CalendarWhich connected calendar the agent reads from and writes to
TimezoneThe timezone used for every slot the agent quotes (see below)
Work hoursDays and time ranges the agent will offer (e.g. Mon–Fri, 09:00–18:00)
Slot durationDefault appointment length (e.g. 30 minutes)
BufferPadding between consecutive appointments (e.g. 15 minutes)

Each agent on your account can configure these independently — useful when one agent books 30-minute sales demos and another books 90-minute consultations from the same calendar.

For the full setup walkthrough including the Outlook equivalent, see Integrations → Google Calendar.

Timezone Handling​

All slot offers, confirmations, and created events use the timezone configured on the agent's calendar tool (e.g. Europe/Vienna, Europe/Berlin, America/New_York). The agent says the timezone out loud when it offers a slot — for example, "Tuesday at three p.m. Vienna time, does that work?" — so the caller never has to guess.

If your caller is in a different timezone, configure the agent to confirm the local equivalent verbally before booking. The created Google Calendar event always stores the time in the configured timezone; Google handles display in each attendee's local zone.

Disconnecting and Reconnecting​

You can disconnect Google Calendar at any time from the Integrations page.

When you disconnect:

  • Stored tokens are removed.
  • Every Google Calendar tool on every agent in your account is deactivated — the tool stays in place on each agent but no longer fires during calls.
  • Existing booked events in Google itself are not deleted or changed.

When you reconnect (or connect a different Google account), the previously deactivated tools reactivate automatically with their old work-hours, slot-duration, and timezone settings — you do not have to re-add the tool on each agent.

You can also revoke HANC's access from your Google account's security settings. The effect is the same as disconnecting from inside HANC; the next call attempting to use the calendar will fail cleanly and the tools will deactivate on next sync.

Booked Appointments in HANC​

Every event the agent creates also shows up in CRM → Calendar alongside any Outlook bookings, with a link back to the contact record of the caller. See CRM → Calendar for the unified view.