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

# Gmail

Gmail is Google's email service used across most business workflows. Connecting Gmail to Duvo lets your agents read, send, and manage emails on your behalf — automating communication workflows that would otherwise require manual inbox work.

## Setup

Click **Enable** on the [Connections page](https://app.duvo.ai/integrations) and authorize with your Google account.

## Capabilities

* **Read and search emails** — Retrieve messages from your inbox using filters, search criteria, or specific senders.
* **Send emails** — Compose and send messages directly from your connected account.
* **Manage drafts** — Create, list, and send draft emails before they go out.
* **Download attachments** — Pull files attached to emails for further processing.
* **Organize your inbox** — Create and manage labels, move messages, and keep your inbox structured.
* **Access account info** — Retrieve your Gmail profile information when needed for workflows.
* **Inbox triggers** — Start a Run automatically when a new email arrives. See [Triggers](#triggers) for filter options.

## Triggers

The Gmail trigger starts a Run when a new email arrives in the connected user's own inbox.

| Field                     | What it does                                                                     |
| ------------------------- | -------------------------------------------------------------------------------- |
| **Senders**               | Only fire for email from matching senders. Leave empty to match any sender.      |
| **Subject keywords**      | Only fire when the subject contains any listed keyword.                          |
| **Email keywords**        | Only fire when the email contains any listed keyword.                            |
| **Recipients**            | Only fire when the email was sent to or copied to matching recipients.           |
| **Labels**                | Only fire when Gmail search matches any listed label name.                       |
| **Has attachment**        | Only fire when the email includes an attachment.                                 |
| **Attachment file names** | Narrow attachment matches by values like `pdf`, `xlsx`, or `invoice`.            |
| **Categories**            | Only fire for selected Gmail categories such as Primary, Promotions, or Updates. |

Filters are optional. When multiple filters are set, the trigger starts a Run only when the email matches all selected filter groups.

<Note>
  The Gmail trigger monitors only the inbox of the account you connected. Shared or delegated Gmail inboxes are not currently supported as trigger sources.
</Note>

## Key Benefits

* **End-to-end email automation** — Handle full communication workflows from monitoring incoming messages to composing and sending replies.
* **Attachment processing** — Extract and work with documents, spreadsheets, and other files sent via email.
* **Your account, your control** — Emails are sent from your own address using your existing permissions.
* **Event-driven workflows** — Use inbox triggers to kick off runs the moment a relevant email lands.
* **Broad workflow coverage** — Supports reading, writing, drafting, labeling, and searching across your entire mailbox.

## Works Well With

<CardGroup cols={3}>
  <Card title="Google Sheets" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-sheets.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=0ef8d55e05c34e7a4a618933bdf0ceb3" href="/user-guide/connections/available-connections/google-sheets" width="24" height="24" data-path="images/connections/google-sheets.svg">
    Extract data from incoming emails and log it into a spreadsheet for tracking orders, support requests, or leads.
  </Card>

  <Card title="Google Drive" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-drive.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=d203935eb0f317c6e9bc44f25fa52cb0" href="/user-guide/connections/available-connections/google-drive" width="87" height="78" data-path="images/connections/google-drive.svg">
    Save email attachments directly to Drive folders for organized document management.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Notify a Slack channel when an important email arrives or after an automated reply is sent.
  </Card>
</CardGroup>

## Workflow Examples

See [Gmail Workflows](/user-guide/examples/gmail-workflows) for step-by-step tutorials covering inbox triage, drafting replies to common inquiries, and extracting structured data from incoming emails.