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

# Gmail

> Read and send emails via Gmail API

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `https://www.googleapis.com/auth/gmail.readonly`, `https://www.googleapis.com/auth/gmail.send`, `https://www.googleapis.com/auth/gmail.modify`, `https://www.googleapis.com/auth/gmail.labels`, `https://www.googleapis.com/auth/gmail.compose`, `https://mail.google.com/`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable               | Required | Description                                                                           |
| ---------------------- | -------- | ------------------------------------------------------------------------------------- |
| `GOOGLE_CLIENT_ID`     | Yes      | Google OAuth Client ID [Docs](https://console.cloud.google.com/apis/credentials).     |
| `GOOGLE_CLIENT_SECRET` | Yes      | Google OAuth Client Secret [Docs](https://console.cloud.google.com/apis/credentials). |

## Tools

| Tool                 | Access | Description                                                                                                                                                              |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| List Emails          | Read   | List Gmail message summaries with IDs, sender, recipient, subject, date, snippet, labels, and pagination tokens. Use get-email only when full message content is needed. |
| Send Email           | Write  | Send an email to recipients                                                                                                                                              |
| Get Email            | Read   | Get a specific email by ID with full content                                                                                                                             |
| Search Emails        | Read   | Search Gmail messages and return summaries with IDs, sender, recipient, subject, date, snippet, labels, and pagination tokens.                                           |
| Mark Email Read      | Write  | Mark an email as read                                                                                                                                                    |
| Archive Email        | Write  | Archive an email                                                                                                                                                         |
| List Labels          | Read   | List Gmail labels                                                                                                                                                        |
| Get Label            | Read   | Get a Gmail label                                                                                                                                                        |
| Create Label         | Write  | Create a Gmail user label                                                                                                                                                |
| Update Label         | Write  | Update a Gmail user label                                                                                                                                                |
| Delete Label         | Write  | Delete a Gmail user label                                                                                                                                                |
| Apply Labels         | Write  | Apply or remove labels on an email                                                                                                                                       |
| Modify Email Labels  | Write  | Modify labels on an email                                                                                                                                                |
| Trash Email          | Write  | Move an email to trash                                                                                                                                                   |
| Untrash Email        | Write  | Remove an email from trash                                                                                                                                               |
| Delete Email         | Write  | Permanently delete an email                                                                                                                                              |
| Batch Modify Emails  | Write  | Modify labels on multiple emails                                                                                                                                         |
| Batch Delete Emails  | Write  | Permanently delete multiple emails                                                                                                                                       |
| List Threads         | Read   | List Gmail threads                                                                                                                                                       |
| Get Thread           | Read   | Get a Gmail thread                                                                                                                                                       |
| Modify Thread Labels | Write  | Modify labels on a Gmail thread                                                                                                                                          |
| Trash Thread         | Write  | Move a Gmail thread to trash                                                                                                                                             |
| Untrash Thread       | Write  | Remove a Gmail thread from trash                                                                                                                                         |
| Delete Thread        | Write  | Permanently delete a Gmail thread                                                                                                                                        |
| Create Draft         | Write  | Create a Gmail draft                                                                                                                                                     |
| List Drafts          | Read   | List Gmail drafts                                                                                                                                                        |
| Get Draft            | Read   | Get a Gmail draft                                                                                                                                                        |
| Update Draft         | Write  | Replace a Gmail draft                                                                                                                                                    |
| Send Draft           | Write  | Send an existing Gmail draft                                                                                                                                             |
| Delete Draft         | Write  | Permanently delete a Gmail draft                                                                                                                                         |
| Get Attachment       | Read   | Get a Gmail message attachment                                                                                                                                           |
| Get Profile          | Read   | Get the Gmail mailbox profile                                                                                                                                            |
| List History         | Read   | List Gmail mailbox history changes                                                                                                                                       |

## Example prompts

* Summarize my unread emails from today. Group them by priority and highlight any that need immediate attention.
* Help me draft a reply to my most recent email. Keep it professional and concise.
* Search my emails for important messages from the past week that I might have missed.