Send Gmail email
Input
to requiredRecipient email address(es). A single string or an array of strings.
subject requiredEmail subject line.
cc optionalOptional Cc address(es). A single string or an array of strings.
bcc optionalOptional Bcc address(es). A single string or an array of strings.
body optionalPlain-text message body.
Default: ""account optionalGoogle account email to send as. Without it, Gmail uses the first signed-in account, which may not be the one you expect if several accounts share the browser.
attachmentMime optionalMIME type of the attachment (e.g. 'application/pdf'). Defaults to a generic binary type if omitted.
attachmentName optionalFilename the recipient sees for the attachment (e.g. 'invoice.pdf'). Defaults to 'attachment' if omitted.
attachmentBase64 optionalBase64-encoded bytes of a file to attach. Optional, omit to send without an attachment. Keep the file small, a few hundred KB or less.
Output
to requiredsent requiredsubject requiredcc optionalbcc optionalFAQ
Search Gmail
Search the signed-in Gmail with the native query syntax (from:, to:, subject:, has:attachment, after:/before:, labels…) and return matching threads: threadId (feed it to get_thread / reply_to_email), sender, senderEmail, subject, snippet, date, unread, starred, hasAttachment. Results are threads rather than individual messages, which is Gmail's own search granularity, and only the first page of results is returned (up to 50).
Forward Gmail thread
Forward an entire Gmail thread to one recipient, with an optional leading note. Takes the hex threadId that search_emails returns, and forwards the whole conversation inline rather than a single message. Returns forwarded, threadId and to. The thread must be on the first page of All Mail, newest-first, so older conversations cannot be reached this way.
Create a Gmail draft
Compose a Gmail message and save it as a draft without sending it. Takes to/cc/bcc, subject and body, and confirms the draft exists in Drafts afterward rather than trusting the compose window closing.