Gmail
for LuumenAI
Vendor and alert mail as context; replies drafted for review.
Meet the team where the conversation already is. LuumenAI reads the relevant Gmail threads for context, posts summaries and status updates on request, and can route held actions to an approver as a message.
The Gmail toolbox
60 tools: 28 read, 32 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadFetch emailsFetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval.
- ReadFetch message by message IDFetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`.
- ReadFetch Message by Thread IDRetrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`.
- ReadGet Gmail attachmentRetrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs.
- ReadGet Auto-Forwarding SettingsGet the auto-forwarding setting for the specified account.
- ReadGet contactsFetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination.
- ReadGet DraftRetrieves a single Gmail draft by its ID.
- ReadGet Gmail filterRetrieve a specific Gmail filter by its ID.
- ReadGet label detailsGets details for a specified Gmail label.
- ReadGet Language SettingsRetrieve the language settings for a Gmail user.
- ReadGet PeopleRetrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return.
- ReadGet ProfileRetrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user.
- ReadGet Vacation SettingsRetrieve vacation responder settings for a Gmail user.
- ReadList CSE identitiesList client-side encrypted identities for an authenticated user.
- ReadList CSE key pairsList client-side encryption key pairs for an authenticated user.
- ReadList DraftsRetrieves a paginated list of email drafts from a user's Gmail account.
- ReadList Gmail filtersList all Gmail filters (rules) in the mailbox.
- ReadList forwarding addressesList all forwarding addresses for the specified Gmail account.
- ReadList Gmail historyList Gmail mailbox change history since a known startHistoryId.
- ReadList Gmail labelsRetrieves all system and user-created labels for a Gmail account in a single unpaginated response.
- ReadList send-as aliasesLists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases.
- ReadList S/MIME configsLists S/MIME configs for the specified send-as alias.
- ReadList threadsRetrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination.
- ReadSearch PeopleSearches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'.
- ReadGet IMAP SettingsRetrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.
- ReadGet POP settingsRetrieve POP settings for a Gmail account.
- ReadGet send-as aliasRetrieve a specific send-as alias configuration for a Gmail user.
- ReadWho Am IReturn the identity (email, name) of the connected Gmail account.
- WriteModify email labelsAdds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs). Approval by default
- WriteBatch delete Gmail messagesPermanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Approval by default
- WriteBatch modify Gmail messagesModify labels on multiple Gmail messages in one efficient API call. Approval by default
- WriteCreate email draftCreates a Gmail email draft. Approval by default
- WriteCreate Gmail filterCreate a new Gmail filter with specified criteria and actions. Approval by default
- WriteCreate labelCreates a new label with a unique name in the specified user's Gmail account. Approval by default
- WriteDelete DraftPermanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Approval by default
- WriteDelete Gmail filterPermanently delete a Gmail filter by its ID. Approval by default
- WriteDelete label from account (permanent)Permanently DELETES a user-created Gmail label from the account (not from a message). Approval by default
- WriteDelete messagePermanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated… Approval by default
- WriteDelete threadImmediately and permanently delete a specified thread and all its messages. Approval by default
- WriteForward email messageForward an existing Gmail message to specified recipients, preserving original body and attachments. Approval by default
- WriteImport messageImport a message into the user's mailbox with standard email delivery scanning and classification. Approval by default
- WriteInsert message into mailboxInsert a message into the user's mailbox similar to IMAP APPEND. Approval by default
- WriteModify thread labelsAdds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. Approval by default
- WriteTrash threadMoves the specified thread to the trash. Approval by default
- WriteMove to TrashMoves an existing, non-deleted email message to the trash for the specified user. Approval by default
- WritePatch LabelPatches the specified user-created label. Approval by default
- WritePatch send-as aliasPatch the specified send-as alias for a Gmail user. Approval by default
- WriteReply to email threadSends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread. Approval by default
- WriteSend DraftSends an existing draft email AS-IS to recipients already defined within the draft. Approval by default
- WriteSend EmailSends an email via Gmail API using the authenticated user's Google profile display name. Approval by default
- WriteStop watch notificationsStop receiving push notifications for a Gmail mailbox. Approval by default
- WriteUntrash MessageRemove a message from trash in Gmail. Approval by default
- WriteUntrash threadRemove a thread from trash in Gmail. Approval by default
- WriteUpdate draftUpdates (replaces) an existing Gmail draft's content in-place by draft ID. Approval by default
- WriteUpdate IMAP settingsUpdate IMAP settings for a Gmail account. Approval by default
- WriteUpdate LabelUpdate the properties of an existing Gmail label. Approval by default
- WriteUpdate Language SettingsUpdate the language settings for a Gmail user. Approval by default
- WriteUpdate POP settingsUpdate POP settings for a Gmail account. Approval by default
- WriteUpdate send-as aliasUpdate a send-as alias for a Gmail user. Approval by default
- WriteUpdate Vacation SettingsUpdate vacation responder settings for a Gmail user. Approval by default
One prompt, start to finish
What a governed Gmail run looks like inside Luumen.
Questions
How does LuumenAI connect to Gmail?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Gmail on its own?
Read actions answer immediately. Anything that writes — modify email labels, batch delete gmail messages, batch modify gmail messages, create email draft, and more — is shown as a plan and requires approval by default, including the 8 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Gmail — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Put Gmail to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.