Gmail
Source: https://runstack.engineer/docs/toolkits/gmail
Read, search, draft, send, and organize emails and threads.
Tools (61):
| Tool | Description |
|---|---|
gmailListMessages | List or search for Gmail messages. Use query parameter for advanced search (e.g., from:someone@example.com, is:unread). |
gmailGetMessage | Get details of a specific Gmail message by ID. |
gmailSendMessage | Send an email via Gmail. |
gmailCreateDraft | Create a draft email in Gmail without sending it immediately. Highly recommended for human-in-the-loop review. |
gmailListDrafts | List drafts in the Gmail mailbox. Optionally filter drafts with a search query. |
gmailGetDraft | Get details, headers, and content of a specific Gmail draft by draft ID. |
gmailSendDraft | Send an existing Gmail draft by its draft ID. |
gmailDeleteDraft | Permanently delete an existing Gmail draft by its draft ID. |
gmailListThreads | List or search email conversation threads in Gmail. Filter by search query (e.g., from:someone@example.com, is:unread). |
gmailGetThread | Get details and all messages in a specific Gmail conversation thread by thread ID. |
gmailReplyToThread | Reply to an existing Gmail conversation thread, ensuring the message stays grouped in the same thread. |
gmailListLabels | List all labels in the Gmail mailbox (e.g., INBOX, UNREAD, STARRED, IMPORTANT, and user custom labels). |
gmailModifyMessageLabels | Add or remove labels from a Gmail message. Used to mark emails as read/unread, star/unstar, archive (remove INBOX), or assign folders/labels. |
gmailTrashMessage | Move a Gmail message to the Trash folder (safe recoverable deletion). |
gmailUntrashMessage | Restore a Gmail message from the Trash folder back to the mailbox. |
gmailBatchDeleteMessages | Permanently delete multiple Gmail messages in one request. This bypasses Trash and cannot be undone. |
gmailBatchModifyMessages | Add or remove labels on multiple Gmail messages in one request. |
gmailCreateFilter | Create a Gmail filter with criteria and actions such as applying labels, forwarding, archiving, or marking read. |
gmailCreateLabel | Create a new user label in Gmail. |
gmailDeleteFilter | Permanently delete a Gmail filter by ID. |
gmailDeleteLabel | Permanently delete a user-created Gmail label from the account. |
gmailDeleteMessage | Permanently delete a Gmail message by ID. This bypasses Trash and cannot be undone. |
gmailDeleteThread | Permanently delete a Gmail thread and all of its messages. This cannot be undone. |
gmailForwardMessage | Forward an existing Gmail message to one or more recipients, optionally preserving attachments. |
gmailGetAttachment | Retrieve a Gmail message attachment by message ID and attachment ID. |
gmailGetAutoForwarding | Get Gmail auto-forwarding settings for the authenticated mailbox. |
gmailGetContacts | Fetch Google contacts for the authenticated account using the People API. |
gmailGetFilter | Retrieve a Gmail filter by ID. |
gmailFetchEmails | Search/list emails with optional hydration: ids_only (fastest), metadata, or full payload. Sort by internalDate client-side; loop page tokens for full coverage. |
gmailGetLabel | Get label details (name, type, visibility, message/thread counts, color) by label ID. |
gmailGetLanguageSettings | Get the Gmail display language (RFC 3066 tag like 'en-GB') for a user. |
gmailGetPeople | Get one person by resource name, or list 'Other Contacts' with pagination/sync tokens. Other-contacts mode restricts person_fields. |
gmailGetProfile | Get mailbox profile (primary email, message/thread totals, historyId). historyId seeds incremental sync via list-history. |
gmailGetVacationSettings | Get vacation responder (out-of-office) settings: enabled flag, subject, bodies, schedule, restrictions. |
gmailImportMessage | Import an RFC 2822 base64url message with delivery scanning/classification (no SMTP, no SPF checks). |
gmailInsertMessage | Insert an RFC 2822 base64url message directly (IMAP APPEND equivalent), bypassing most scanning. Does not send. |
gmailListCseIdentities | List client-side encryption sending identities with key-pair associations (Workspace CSE only). |
gmailListCseKeypairs | List client-side encryption key pairs (public certs, enablement state). Paginate with page tokens. |
gmailListFilters | List all Gmail filters. Audit for malicious rules or check for duplicates before creating new ones. |
gmailListForwardingAddresses | List verified forwarding addresses (accepted/pending) usable as auto-forward targets. |
gmailListHistory | List mailbox changes since a history ID for incremental sync. Persist the newest historyId as checkpoint; empty history is valid (no changes). |
gmailListSendAs | List send-as aliases (primary + custom From addresses) with signatures and verification status. Use before composing from an alias. |
gmailListSmimeInfo | List S/MIME certificate configs for a send-as alias. Needs Workspace Enterprise Plus/Education/Frontline with S/MIME enabled. |
gmailModifyThreadLabels | Add/remove label IDs on a whole thread (all messages). For single messages use modify-message-labels instead. |
gmailMoveThreadToTrash | Move a thread and all its messages to trash (recoverable via untrash-thread). |
gmailPatchLabel | Partially update a user label (name, visibility, color with both subfields). System labels are rejected. |
gmailPatchSendAs | Partially update a send-as alias (display name, signature, reply-to, default flag, SMTP relay). |
gmailSearchPeople | Search saved contacts (+ Other Contacts optionally) by name/email/phone/org. Never auto-pick from ambiguous results; dedupe by email across pages. |
gmailSettingsGetImap | Get IMAP settings: enabled flag, auto-expunge, expunge behavior, folder size limit. |
gmailSettingsGetPop | Get POP settings: access window and post-fetch disposition. |
gmailSettingsSendAsGet | Get one send-as alias config (display name, signature, SMTP relay, verification). 404 if the address is not an alias. |
gmailStopWatch | Stop Gmail push notifications for the mailbox previously configured via watch. |
gmailUntrashThread | Restore a trashed thread and its messages. |
gmailUpdateDraft | Replace a draft entirely by ID (full replace, not patch). Provide complete content; attachments via public URL only. |
gmailUpdateImapSettings | Update IMAP settings (enabled, autoExpunge, expungeBehavior, maxFolderSize of 0/1000/2000/5000/10000). |
gmailUpdateLabel | Fully update a user label (PUT). Same fields as patch; provide the complete desired state. |
gmailUpdateLanguageSettings | Set the Gmail display language. Gmail may save a close variant if the exact tag is unsupported. |
gmailUpdatePopSettings | Update POP access window (disabled/fromNowOn/allMail) and disposition (leaveInInbox/archive/trash/markRead). |
gmailUpdateSendAs | Fully update a send-as alias. Same fields as patch; non-primary aliases updatable only with domain-wide delegation. |
gmailUpdateVacationSettings | Configure out-of-office auto-replies. Either responseSubject or responseBodyPlainText must be non-empty to activate. |
gmailWhoAmI | Return the connected account identity (sub, name, email, hosted domain) via userinfo + Gmail profile. |