# Gmail AI connector guide

Connect Gmail data to AI agents with Combined. Explore profile, drafts, labels, source setup, MCP access and read-only business queries.

Combined offers 1,125 connectors across catalog sources and connectors generated through desktop automation.

## Connect

1. Open Combined Connected Apps and select Gmail.
2. Authorize the source and choose the relevant datasets.
3. Complete a first sync, then grant your agent access through the Set up or Access workspace.
4. Discover the actual source schemas before querying.

## Setup reference

- Authentication: required in the upstream source schema; Authenticate via Google (OAuth) or Service Account Key Authentication
- Client ID: depends on the selected authentication/setup option
- Refresh Token: depends on the selected authentication/setup option
- Client Secret: depends on the selected authentication/setup option
- Service Account Information.: depends on the selected authentication/setup option
- Include Spam & Trash: optional
- Number of concurrent workers: optional
- Start date: optional

## Dataset reference

- profile
- drafts; key: id
- labels; key: id
- labels_details; key: id
- messages; key: id
- messages_details; key: id; update field: internalDate
- threads; key: id
- threads_details; key: id

This is the upstream connector reference, version 0.1.12. Account permissions and sync configuration determine the datasets available in your workspace.

## Agent prompt

Use Combined to analyze my Gmail data.
List my granted sources, discover the datasets and describe their fields.
Look for datasets corresponding to profile, drafts, labels, labels_details, messages, messages_details.
Check the last successful sync and report the available date coverage.
Propose three useful questions based on the fields actually available.
For the question I choose, run read-only SQL over the complete matching dataset.
Use a bounded result; include source names, time window and query receipt.
Ask for a missing join key or metric definition instead of inventing one.

## Links

- Combined: https://www.trycombined.com/
- Setup: https://www.trycombined.com/docs/getting-started/onboarding
- MCP: https://www.trycombined.com/docs/integrations/mcp
- Pricing: https://www.trycombined.com/pricing
- Upstream source reference: https://docs.airbyte.com/integrations/sources/gmail
- Full guide: https://www.trycombined.com/connectors/gmail