---
title: "Gmail integration for LuumenAI"
url: "https://www.luumen.ai/integrations/gmail/"
entity: SoftwareIntegration
category: "Communication"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Gmail integration for LuumenAI

Vendor and alert mail as context; replies drafted for review.

## What LuumenAI can do with Gmail

LuumenAI connects to Gmail with OAuth 2.0 and exposes 60 tools (28 read-only · 24 write · 8 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: OAuth 2.0
- Tools available: 60 tools (28 read-only · 24 write · 8 destructive)
- Plan: available on all plans
- Category: Communication

## About Gmail with LuumenAI

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.

## Example tools

Read-only (28 in total):

- `GMAIL_FETCH_EMAILS` — Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval.
- `GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID` — Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`.
- `GMAIL_FETCH_MESSAGE_BY_THREAD_ID` — Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`.
- `GMAIL_GET_ATTACHMENT` — Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs.
- `GMAIL_GET_AUTO_FORWARDING` — Get the auto-forwarding setting for the specified account.
- `GMAIL_GET_CONTACTS` — Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination.
- `GMAIL_GET_DRAFT` — Retrieves a single Gmail draft by its ID.
- `GMAIL_GET_FILTER` — Retrieve a specific Gmail filter by its ID.

Write and destructive (32 in total, approval required by default):

- `GMAIL_ADD_LABEL_TO_EMAIL` — Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs).
- `GMAIL_BATCH_DELETE_MESSAGES` — Permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible.
- `GMAIL_BATCH_MODIFY_MESSAGES` — Modify labels on multiple Gmail messages in one efficient API call.
- `GMAIL_CREATE_EMAIL_DRAFT` — Creates a Gmail email draft.
- `GMAIL_CREATE_FILTER` — Create a new Gmail filter with specified criteria and actions.
- `GMAIL_CREATE_LABEL` — Creates a new label with a unique name in the specified user's Gmail account.
- `GMAIL_DELETE_DRAFT` — Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling.
- `GMAIL_DELETE_FILTER` — Permanently delete a Gmail filter by its ID.

## Frequently asked 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 is shown as a plan and requires approval by default, including the 8 actions classified as destructive. Administrators configure that per tool.

### 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.

Full page: https://www.luumen.ai/integrations/gmail/