> For the complete documentation index, see [llms.txt](https://actlysai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://actlysai.gitbook.io/docs/supported-protocols-and-platforms/apps/gmail.md).

# Gmail

AI agents can make Gmail easier to use by handling common email tasks for you. Here are the main things you can do, with examples:

### 1. Work with labels

Organize your inbox with labels.

Examples:

* Show all my Gmail labels.
* Get details for the “IMPORTANT” label.
* Create a label named “Test”.
* Rename the label “Test” to “Test2”.
* Delete the label “Test2”.

### 2. Manage messages

Find, read, or organize individual emails.

Examples:

* Show my last 10 emails.
* Find the last 25 emails from <invoices@acme.com> in the last 30 days.
* Show the most recent email in Trash.
* Get the full content of my latest email.
* Move message ID 1894a7d2f3c1a4b5 to Trash.
* &#x20;Restore message ID 1894a7d2f3c1a4b5 from Trash.
* For message ID 1894a7d2f3c1a4b5, mark it as read, add the label “Receipts 2025”, and remove the label “To Process”.

### 3. Manage threads

Work with whole conversations instead of single emails.

Examples:

* List 20 threads matching “subject:Quarterly Report newer\_than:90d”.
* Get the full thread with ID 198ad70bc50232a3.
* For thread ID 17c9d1aa2bf34e00, mark all messages as read, add label “Finance”, and remove label “Unread”.
* Move thread ID 17c9d1aa2bf34e00 to Trash.
* Restore thread ID 17c9d1aa2bf34e00 from Trash.
* Permanently delete thread ID 17c9d1aa2bf34e00.

### 4. Work with drafts

Prepare messages before sending them.

Examples:

* Show my last 10 drafts.
* Create a draft to <jane.doe@example.com>, subject “Q3 plan”, body “Hi Jane, here is the draft plan for Q3, let me know your edits.”
* Get draft ID rfc822-6e91c2d1e3a54700.
* Update draft ID rfc822-6e91c2d1e3a54700, change subject to “Q3 plan v2”, and add “Added milestones for July.”
* Delete draft Q3 plan
* Send draft with the subject: Q3 plan&#x20;

### 5. Send email

Write and send new emails directly.

Example:

* Send an email to <test@gmail.com>, cc <test2@gmail.com>, subject “Invoice 8471, July 2025”, body “Hi team, attached is invoice 8471 for July, please confirm receipt.”, reply to me, and request a read receipt.