Skip to main content

Google Calendar

Connect a Google account so assistants can read that person's Google Calendar and, when you allow it, create events there. Google Calendar is a per-member connection: each workspace member connects their own Google account. Workspace admins enable the feature; members authorize their own OAuth grants.

This is the same Google grant used by workspace calendar sync on the Calendars Sync tab. Connecting once covers both: assistants can use the member-linked calendar, and you can link a Gravity Rail calendar to a Google Calendar for two-way event sync.

Before You Start​

You'll need:

  1. The Google Calendar feature enabled on your workspace. If you don't see Google Calendar in the App Connections directory, ask your Gravity Rail administrator to turn on the Calendar feature.
  2. A Google account with access to the calendars you want assistants or sync to use.
  3. If the account is on Google Workspace, a domain admin must allow Gravity Rail first. Personal @gmail.com accounts do not need this. See Google Workspace Accounts.

HIPAA note for healthcare workspaces. Google Calendar is a third-party system and, for most Gravity Rail customers, is not covered by a Business Associate Agreement. Avoid putting Protected Health Information (patient names, diagnoses, medication details, clinical notes) in event titles, descriptions, or attendee notes. Use generic titles (e.g., "Consultation — Member #1234") and keep clinical detail in the Gravity Rail chat or form record instead.

Connecting Your Google Account​

From App Connections​

  1. Go to App Connections and open the Directory tab.
  2. Find Google Calendar (Google category) and click Install.
  3. Click Connect — you'll be redirected to Google's authorization page.
  4. Sign in with the Google account whose calendars you want to use.
  5. Review and approve the requested permissions (see Required Permissions below).
  6. You'll be redirected back to your workspace. The new connection appears on the Active tab under Platform Integrations.

From the Calendars Sync tab​

  1. Go to Calendars and open the Sync tab.
  2. In the Google Calendar card, click Connect Google Calendar.
  3. Sign in to Google and grant calendar access.
  4. You'll return to the Sync tab with a green Connected badge.

Once connected, the Sync tab lists the Google calendars on that account so you can link them to a Gravity Rail calendar.

Connecting Multiple Google Accounts​

  1. On the Active tab, open the Google Calendar connection.
  2. Click Add account and repeat the OAuth flow with the second account.
  3. Assistants see all connected accounts when listing available connections.

Connecting During a Chat​

If the workspace has inline connect enabled and you don't yet have a Google Calendar connection, an assistant may prompt you to connect from the chat.

Required Permissions​

Gravity Rail requests the following Google OAuth scopes when you connect:

ScopeWhy it's needed
calendarRead events, create events, and sync with a Gravity Rail calendar
userinfo.email, userinfo.profile, openidIdentify which Google account is connected

The assistant's tools follow the Calendar ability's access mode in Gravity Rail. A read-only ability can list events but cannot create or update them, even though the calendar scope was requested at connect time.

What Assistants Can Do​

Once your Google account is connected, assistants with the integration:google_calendar ability can:

ToolWhat it does
List connectionsShow which Google accounts you have connected
Today's eventsList events on the connected Google Calendar for today
List eventsList events in a date range, optionally filtered by title
Create eventCreate an event, including optional attendee invites (read-write access mode only)
Update eventChange an existing event's time, title, or attendees (read-write access mode only)
Reconnect accountRe-authorize a connected account if the token has expired

Workspace booking calendars (availability, event types, public booking) are a different surface — see Calendars and Calendar Booking.

Managing Your Connection​

Viewing Connected Accounts​

Go to App Connections → Active tab and open Google Calendar. Each row shows the connected Google email address and connection status.

Reconnecting an Expired Account​

If your OAuth token expires or is revoked, the connection shows a Reauthorize Required badge, or the Calendars Sync tab shows a yellow "permissions need to be updated" banner:

  1. Click Reauthorize on the connection, or Reconnect Google Account on the Sync tab.
  2. Sign in to Google and approve the calendar scopes again.

Removing an Account​

  1. Open the Google Calendar connection on the Active tab.
  2. Click the action menu next to the account you want to remove.
  3. Choose Disconnect.

Disconnecting from the Calendars Sync tab removes Gravity Rail's access for every linked calendar. Previously synced events stay in Gravity Rail as local-only events.

Also revoke from Google. Removing the connection in Gravity Rail deletes our copy of the OAuth token, but Google keeps its own record of the grant. To fully revoke access, visit myaccount.google.com/permissions and remove the Gravity Rail app.

Troubleshooting​

"This app is blocked" or admin_policy_enforced​

The Google account is on a Workspace domain that blocks unverified third-party apps. Send Google Workspace Accounts to your Google Workspace admin and retry after they mark the Calendar client as Trusted.

Sign-in with Google can still work on the same domain. Sign-in only asks who you are; Calendar asks to read and write events.

"Reauthorize Required" or permissions banner​

Google has revoked or expired the access token. Common causes:

  • The token hasn't been used for six months
  • You changed your Google account password
  • You revoked access at myaccount.google.com/connections
  • An admin in your Google organization restricted third-party app access

Click Reauthorize or Reconnect Google Account and complete consent again.

Assistant can't see events​

  • Confirm you connected the Google account that owns (or can see) those events.
  • Shared calendars only appear if that Google account already has access in Google Calendar.

"Google Calendar not available" or missing from the Directory​

The Calendar feature is not enabled on your workspace. Ask your Gravity Rail administrator to enable it.