> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail

> Sync emails from Gmail to auto-create contacts and log communication.

Connects to Gmail via OAuth. Pulls emails, extracts contacts from sender/recipient fields, logs each email as a communication on the matching contact record, and builds email relationship edges in the graph.

<Note>
  Gmail OAuth is currently under Google verification. You may see a warning screen during the OAuth flow. Click "Advanced" → "Go to Supersonic" to proceed.
</Note>

## What gets synced

* **Emails** — subject, body, sender, recipients (to/cc/bcc), thread ID, timestamps
* **Contacts** — auto-created from email addresses. Names are extracted from email headers. Duplicates are merged by email address.
* **Relationships** — `emailed` edges between contacts who exchanged emails, `co_threaded` for participants in the same thread, `works_at` linking contacts to companies by email domain

## What gets filtered

Automated and transactional emails are excluded:

* No-reply addresses, newsletters, service notifications
* Emails from known SaaS platforms (GitHub, Slack, Stripe, etc.)
* Marketing and transactional senders

## Connect

1. Go to **Sources** in the dashboard
2. Click **Connect** next to Gmail
3. Authorize Supersonic in the Google OAuth screen
4. Initial sync starts automatically

## Sync frequency

* **Initial sync** — pulls all emails (may take a few minutes for large inboxes)
* **Incremental sync** — every 5 minutes, checks for new emails since last sync

## Data access

Emails are stored in the Communication model and linked to contact records. Access them via:

```bash theme={null}
# List recent emails
supersonic notes list --record <contact-id>

# Or via the timeline
supersonic timeline <contact-id>
```