Gmail
Send, manage drafts, and optionally read Gmail message contents
OAuth10 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
POST
google_gmail_send_message
Send an email immediately (RFC 2822 message, base64url-encoded)
/users/me/messages/send
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| raw | string | required | The entire RFC 2822 formatted email (headers + body), base64url-encoded (matches Gmail API's messages.send resource) |
| threadId | string | optional | Thread ID to associate this message with, for replies |
GET
google_gmail_list_messages
List message IDs/thread IDs, optionally filtered by Gmail search or label IDs
/users/me/messages
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Gmail search query to filter messages |
| labelIds | array | optional | Only return messages with all of these label IDs |
| maxResults | integer | optional | Maximum number of messages to return |
| pageToken | string | optional | Page token for pagination |
| includeSpamTrash | boolean | optional | Include SPAM and TRASH in results |
GET
google_gmail_get_message
Get a Gmail message from this connection, including its headers and body when format is full or raw; use an ID returned by this connection's list_messages
/users/me/messages/{id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Gmail message ID |
| format | string | optional | Response format; full includes parsed body parts and raw includes RFC 2822 |
| metadataHeaders | array | optional | Headers to include when format is metadata |
GET
google_gmail_list_labels
List all labels (system and user-created) in the mailbox
/users/me/labels
POST
google_gmail_create_draft
Create a new draft email
/users/me/drafts
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| message | object | required | Draft message resource, e.g. { raw: '<base64url RFC 2822 message>', threadId?: '...' } |
GET
google_gmail_list_drafts
List drafts in the mailbox
/users/me/drafts
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Gmail search query to filter drafts |
| maxResults | integer | optional | Maximum number of drafts to return |
| pageToken | string | optional | Page token for pagination |
| includeSpamTrash | boolean | optional | Include SPAM and TRASH in results |
GET
google_gmail_get_draft
Get a single draft by ID
/users/me/drafts/{id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
| format | string | optional | Response format: full, metadata, minimal, or raw |
PUT
google_gmail_update_draft
Replace an existing draft's message content
/users/me/drafts/{id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
| message | object | required | Replacement draft message resource, e.g. { raw: '<base64url RFC 2822 message>', threadId?: '...' } |
DELETE
google_gmail_delete_draft
Permanently delete a draft
/users/me/drafts/{id}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID |
POST
google_gmail_send_draft
Send an existing draft as-is
/users/me/drafts/send
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| id | string | required | Draft ID to send |