List all configured Gmail accounts and their authentication status

Switch the active Gmail account for this session. All subsequent tool calls use this account by default unless overridden.

Authenticate a Gmail account via OAuth. Opens a browser for Google consent.

Legacy search returning an array of Gmail message metadata using Gmail query syntax.

Paginated rich Gmail search. Prefer this for triage because it returns messages, nextPageToken, and resultSizeEstimate.

Read a specific Gmail message by ID, including full body content

Read explicit shortlisted Gmail message IDs. Use after search when snippets are insufficient.

Read a Gmail thread. Pass thread_id for legacy behavior, or id plus id_type=message/thread. max_messages returns the most recent N messages.

List all Gmail labels for an account

Create a Gmail label, or return the existing label if one already has this name.

Create a Gmail filter. Label names must already exist and are resolved to label IDs.

List all Gmail filters for an account

Delete one Gmail filter by its filter ID

Apply or remove Gmail labels on explicit message IDs. Does not accept queries.

Archive explicit Gmail message IDs by removing INBOX. Does not accept queries.

Stage explicit messages for Trash. Must be confirmed with gmail_confirm_trash_messages.

Confirm and move previously staged messages to Trash using the confirmation code.

Preview and stage a capped query-based bulk label operation. Nothing changes until gmail_confirm_bulk_label_operation.

Confirm a staged bulk label operation using the confirmation code.

Create a draft email (does NOT send it)

List Gmail drafts with summarized metadata.

Update an existing Gmail draft. Omitted fields preserve current values. Drafts with attachments are rejected.

Create draft forwards for source messages. Source attachments are not preserved in v1.

Get Gmail profile info for an account (message/thread counts)

Stage a draft for sending. Returns a preview and confirmation code. The draft is NOT sent until gmail_confirm_send.

Confirm and send a previously staged draft. Code expires after 60 seconds.

Download an email attachment to a sandboxed quarantine directory. Returns local path, SHA-256 hash, and image flag.

Search Google Docs visible to an account by title using Drive metadata only.

Get Google Drive file metadata visible to an account. Does not download file content.

List comments on a Google Drive file visible to an account. Uses existing narrow Drive access and does not broaden scopes.

List coarse Drive revisions for a file visible to an account. For native Docs, this is not the full editor version history.

Read text and tables from a Google Doc visible to an account.

Create a Google Drive folder visible to an account. Uses the narrow drive.file scope.

Upload an explicit local file to Google Drive for an account. Uses the narrow drive.file scope.

Create a native Google Doc from plain text in Google Drive. Uses the narrow drive.file scope.