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 work with your mailbox — triage new mail, draft replies, search threads, or send a message. Because email is sensitive, prefer the ask-first approval policy for send actions.

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 Settings → Tools.
  2. Enable Gmail. Restrict to the actions you want — e.g. allow fetch emails and create draft but require approval for send email.
  3. Set the approval policy (recommended: ask-first for send).
  4. Save.

Try it

Ask the cybo something like @inbox summarize my unread email from today or draft a reply to the latest message from Alex. For a send action, approve it when prompted.

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 — the send action wasn't granted, or its approval is pending.