List Gmail drafts
Input
account optionalGoogle account email whose drafts to list. Without it Gmail opens the first signed-in account (u/0), which may not be the one wanted when several accounts share the browser.
Output
drafts requiredreturned requiredHow many drafts this read returned.
reportedTotal requiredTotal drafts as Gmail itself counts them next to the Drafts folder. Compare against `returned`: a larger figure means the mailbox holds more drafts than this screenful covers. Null when Gmail shows no count.
FAQ
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).
Send Gmail email
Send an email from the signed-in Gmail account, with a plain-text body and an optional single file attachment. Always starts a new conversation. To answer inside an existing thread, use mail.google.com/reply_to_email.
Get Gmail thread
Read a Gmail thread by its hex threadId (as returned by search_emails): subject plus every rendered message's from, fromEmail, to, date, plain-text body and attachment names. In long threads Gmail collapses older messages, so only rendered (expanded) messages are returned.