← Tools Reference

Gmail

Send email and manage drafts (send/draft/metadata-level access only)

OAuth9 toolshttps://gmail.googleapis.com/gmail/v1
POST
google_gmail_send_message
Send an email immediately (RFC 2822 message, base64url-encoded)

/users/me/messages/send

2 parameters
ParamTypeRequiredDescription
rawstringrequiredThe entire RFC 2822 formatted email (headers + body), base64url-encoded (matches Gmail API's messages.send resource)
threadIdstringoptionalThread ID to associate this message with, for replies
GET
google_gmail_list_messages
List message IDs/thread IDs matching a query (metadata-level only; use get_draft/get_message-equivalent tools for content)

/users/me/messages

5 parameters
ParamTypeRequiredDescription
qstringoptionalGmail search query, e.g. 'from:someone@example.com is:unread'
labelIdsarrayoptionalOnly return messages with all of these label IDs
maxResultsintegeroptionalMaximum number of messages to return
pageTokenstringoptionalPage token for pagination
includeSpamTrashbooleanoptionalInclude SPAM and TRASH in results
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
ParamTypeRequiredDescription
messageobjectrequiredDraft 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
ParamTypeRequiredDescription
qstringoptionalGmail search query to filter drafts
maxResultsintegeroptionalMaximum number of drafts to return
pageTokenstringoptionalPage token for pagination
includeSpamTrashbooleanoptionalInclude SPAM and TRASH in results
GET
google_gmail_get_draft
Get a single draft by ID

/users/me/drafts/{id}

2 parameters
ParamTypeRequiredDescription
idstringrequiredDraft ID
formatstringoptionalResponse format: full, metadata, minimal, or raw
PUT
google_gmail_update_draft
Replace an existing draft's message content

/users/me/drafts/{id}

2 parameters
ParamTypeRequiredDescription
idstringrequiredDraft ID
messageobjectrequiredReplacement 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
ParamTypeRequiredDescription
idstringrequiredDraft ID
POST
google_gmail_send_draft
Send an existing draft as-is

/users/me/drafts/send

1 parameter
ParamTypeRequiredDescription
idstringrequiredDraft ID to send