Gmail
Manage Gmail email from the agent.
Gmail
Lets the agent find, read, send, move and delete email in Gmail. It requires a Google Gmail connection configured in the workspace.
The available operations
When you add this tool, choose which operations the agent is allowed to perform.
Find email
Searches the inbox with a query in Gmail's own format.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Query | Yes | — | The search criteria, Gmail-style (e.g. from:joao@example.com, subject:meeting, is:unread, has:attachment) |
| Maximum results | No | 10 | How many messages to return at most |
| Include spam and bin | No | false | With true, messages in the spam and bin folders are included |
Get an email
Returns one message's details by its ID.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Email ID | Yes | — | The message's unique ID |
| Format | No | full | How much detail comes back: full (with the body), metadata (headers only), minimal or raw |
Send an email
Sends a message from the connected Gmail account.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| To | Yes | — | The main recipients' addresses |
| CC | No | — | The addresses to copy |
| BCC | No | — | The addresses to blind-copy |
| Subject | Yes | — | The message's subject |
| Body | Yes | — | The message's content |
| Body is HTML | No | false | With true, the body is treated as HTML. With false, it is sent as plain text |
| Reply-to | No | — | The address replies should go to |
| Thread ID | No | — | The thread's ID, to send the message as a reply within an existing conversation |
Move an email
Moves a message to a different folder by adding or removing Gmail labels.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Email ID | Yes | — | The unique ID of the message to move |
| Labels to add | No | — | The label IDs to add (e.g. INBOX, STARRED, Label_123) |
| Labels to remove | No | — | The label IDs to remove (e.g. INBOX, UNREAD) |
At least one of "Labels to add" or "Labels to remove" has to be given.
Delete an email
Removes a message, either to the bin or permanently.
| Parameter | Required | Default | What it is |
|---|---|---|---|
| Email ID | Yes | — | The unique ID of the message to remove |
| Move to bin | No | true | With true, the message goes to the bin (recoverable). With false, it is deleted permanently |