Google integrations
OAuth, API-key, and account setup for Google providers in Mobius.
Google integrations connect Google accounts or Google API keys to Mobius so assistants can read, write, or react to Google products.
Use this page to choose the right Google provider before connecting a specific integration.
Provider map
| Provider | Connects with | Runs with | Use when |
|---|---|---|---|
| Gmail | Google OAuth or Workspace service account | Mailbox permissions | An assistant should draft, send, label, archive, or reply from a mailbox. |
| Google Calendar | Google OAuth | Calendar event permissions | An assistant should create, update, delete, or respond to calendar events. |
| Google Drive | Google OAuth | Drive file permissions | Selected Google Sheets or Docs files should emit update events. |
| Google Sheets | Google OAuth or service account | Spreadsheet permissions | An assistant should read or write spreadsheet values. |
| Google Places | Google Maps Platform API key or platform credential | Places API quota | An assistant should search places, nearby businesses, or place details. |
| Google Gemini | Google AI API key | Gemini API quota | assistants should use your Google AI account for Gemini models or media actions. |
When in doubt, connect the provider that owns the data the assistant needs to read or write. Use Google Drive only for file-change events. Use Google Sheets for cell data.
Credential model
Workspace providers use Google OAuth, the familiar Google sign-in flow, when the deployment has a shared Google OAuth app configured. The person who signs in manages that connection unless an administrator chooses Your team.
Gmail and Google Sheets can also use a Google Workspace service account. This is a business credential, so only an organization administrator can connect it and the team manages it. Use a service account for a shared mailbox or sheet whose operation should not depend on one person's membership.
After either kind of connection, its manager must grant the exact account to selected assistants. That Mobius account grant is separate from the consent Google records during sign-in. Adding Google tools to an assistant does not grant the Google account. See Connect accounts for the account access and result-audience flow.
Google Places and Google Gemini use API keys. If a provider page says the organization is using Mobius built-in credentials, usage counts against Mobius plan credits. If it says the organization is using your key or account, upstream usage uses your Google quota and does not spend Mobius plan credits for that provider.
Disconnecting a Google OAuth integration removes the Mobius connection. It does not revoke the Google grant, because multiple Mobius Google providers can share the same Google OAuth app and revoking the grant can break other connected Google integrations. Revoke the app from your Google account or Workspace admin console when you want to remove the upstream authorization.
If Continue with Google is unavailable, the Google connection is not enabled for your Mobius organization. Ask your organization administrator or Mobius support to check it. You do not need to configure Mobius server credentials from this page.
Events and watches
Gmail, Google Calendar, and Google Drive emit source events. Google callbacks usually say that something changed, then Mobius fetches the changed object with the stored OAuth credentials before emitting the source event.
Google can send an initial sync callback when a watch is created. Mobius uses
that callback to confirm the watch and does not emit events for historical
state.
Next
- Connect Gmail for mailbox events and mail actions.
- Review account managers and assistant access in Connect accounts.
- Use source events to inspect incoming Google events.