Connect Google / Gmail

Connecting Google / Gmail lets an agent 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.

Requirements

• Composio is connected on a machine that is online (it brokers the Google sign-in).
• You can sign in to the Google account you want to connect.

Connect your Google account

1. Open Settings → Integrations and find Gmail (search with Search all apps, or use Browse all). Click its row to open the sheet.
2. Under Your account, click Connect account. The agent then acts as your Google account, which suits your own inbox.
3. To connect a shared mailbox, admins use Shared account → Connect shared account. A shared account is required for scheduled or unattended email jobs.
4. Google’s sign-in screen opens. Choose the account, then review and approve the requested permissions.
5. Gmail shows Connected in Cyborg7.

Grant Gmail to an agent

Use either method:

1. In the same sheet, under Agents with access, choose Add agent and pick the agent.
2. Or open the agent’s editor, go to the Tools step, enable Gmail under For this agent, choose Acts as (Whoever runs it or Shared account), and save.

The agent gets Gmail’s read actions (fetch emails, list labels, list threads, and so on), up to the 30-action cap.

Example

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

Troubleshooting

• “insufficient permission” or a scope error: reconnect and approve all requested permissions.
• Google blocks the sign-in: the Google account or its organization may restrict third-party apps. Ask its administrator to allow the app.
• The agent can read but not send: send is a write action, and writes are not granted yet.
• Personal accounts aren't set up on <machine> yet: connect Composio on that machine first (see Connect Composio).