Google Calendar
Check availability, book, reschedule, and cancel events on a connected Google Calendar during a live call.
The Google Calendar connector lets your voice agents check free/busy status and book, reschedule, or cancel events on your organization's connected Google Calendar directly from a conversation.
Connect it
- Go to /connectors and click Connect on Google Calendar (or Gmail — either one authorizes both).
- Talkr shows you a redirect URI — register it in your Google Cloud OAuth client.
- Enter your OAuth client's Client ID and Client Secret, then click Save & Authorize.
- You're redirected to Google's consent screen. Approve access, and you're returned to Talkr connected.
Google Calendar and Gmail share a single Google OAuth app and connection — authorizing one connects both, and the actions from both connectors become available together.
Actions
All actions operate on the connected account's primary calendar.
| Action | Description | Parameters |
|---|---|---|
check_availability | Check whether the primary calendar is free between two times. | start_time (required, RFC3339), end_time (required, RFC3339) |
create_event | Book an event on the primary calendar. | summary (required), start_time (required, RFC3339), end_time (required, RFC3339), attendee_email |
reschedule_event | Move an existing event to a new start/end time. | event_id (required), start_time (required, RFC3339), end_time (required, RFC3339) |
cancel_event | Cancel (delete) an existing event. | event_id (required) |
Attach these to a workflow node like any other tool — see Tools for how tool attachment and invocation work.
Example
A scheduling agent calls check_availability for the time the caller proposes, offers alternatives if it's busy, then calls create_event with the agreed time and the caller's email as an attendee — keeping the returned event_id in context. If the same caller calls back to change plans, the agent calls reschedule_event with that ID and the new time, or cancel_event if they want to cancel outright.