Connect Google / Gmail

Let a cybo read, draft, and send email from your Google account — connect the Gmail toolkit and grant it.

Connecting Google / Gmail lets a cybo read your mailbox — triage new mail, search threads, pull a message. Sending and drafting are not granted: write actions are excluded from a grant today, and the ask-first approval flow that would gate them does not exist yet. See what a grant covers.

Before you start

  • Composio is connected (it brokers the Google OAuth).
  • You can sign in to the Google account you want to connect.

Connect your Google account

  1. Open Settings → Integrations and find Gmail (Google).
  2. Click Connect.
  3. Choose the identity:
    • Personal — the cybo acts as your Google account. Best for your own inbox.
    • Shared workspace account (admin) — a shared mailbox, required for scheduled/unattended email jobs.
  4. Google's OAuth screen opens. Choose the account, then review and approve the requested scopes (read, compose, send). Google may show an "unverified app" notice for self-hosted deployments — continue if you trust your deployment.
  5. Gmail shows Connected in Cyborg7.

Grant Gmail to a cybo

  1. Open the cybo's Tools step.
  2. Enable Gmail.
  3. Save. The cybo gets Gmail's read actions (fetch emails, list labels, list threads, …), up to the 30-action cap.

Try it

Ask the cybo something like @inbox summarize my unread email from today or what did Alex send me this week.

Troubleshooting

  • "insufficient permission" / scope error — reconnect and approve all requested scopes; read-only consent can't send or draft.
  • Google blocks the sign-in — for self-hosted setups, add the account as a test user on your Google Cloud OAuth consent screen, or use a Workspace account.
  • The cybo can read but not send — expected: send is a write action, and writes are not granted yet.