Messaging
Gmail
A Gmail integration connects a Gmail mailbox to Mobius so loops can receive message events, search mail, read threads, send replies, create drafts, and update message labels.
Use Gmail when incoming mail should start a durable run or when the run needs to respond from the connected mailbox. Gmail sync is driven by provider state, so a first sync can take a short moment before the first event appears.
Capability map
| Capability | Value |
|---|---|
| Provider ID | gmail |
| Auth kind | oauth2_user |
| Connect flow | OAuth2 user grant or Google Workspace service account JSON |
| Actions | Yes |
| Events | Yes |
| Sync | Yes |
| Webhook delivery | Yes, through Google Pub/Sub push when configured |
| Live status | No |
Connect Gmail
| Surface | Support |
|---|---|
| App | Open Govern > Integrations, choose Gmail, then use Google OAuth or a Workspace service account key. |
| CLI | The mobius CLI does not connect Gmail integrations yet. Use the app or API. |
| API | Call POST /v1/projects/{project}/integrations/providers/gmail/connect. Send an empty body for OAuth or service_account_key for service-account mode. |
OAuth mode is best for personal Gmail mailboxes. Service-account mode is best for Google Workspace mailboxes with domain-wide delegation. Gmail can still appear in the provider catalog when Google OAuth is not configured, but the OAuth button only appears on deployments with shared Google OAuth credentials.
Actions
gmail.label.list
gmail.message.archive
gmail.message.create_draft
gmail.message.get
gmail.message.list
gmail.message.mark_read
gmail.message.mark_unread
gmail.message.modify_labels
gmail.message.reply
gmail.message.send
gmail.message.trash
gmail.message.untrash
gmail.thread.get
gmail.thread.listUse gmail.message.get or gmail.thread.get before replying if the run needs
full body context. Use draft creation when a human should review mail before it
is sent.
Events
gmail.message.receivedUse gmail.message.received to start intake loops from new mail. The event
payload contains a stable message reference; fetch the full message or thread
inside the run when you need body content.
Deployed Mobius environments provision the Google Pub/Sub topic, push subscription, webhook token, and Cloud Run environment variables through Terraform. Without Pub/Sub, Gmail still emits the same event from the regular sync cadence.
Next
- Use source events to debug incoming mail.
- Add human review with interactions.
- Store durable outputs as artifacts.