Search Gmail using Gmail query syntax (e.g. 'from:alice@example.com', 'is:unread', 'subject:invoice'). Returns message summaries.

Get the full content of an email by its ID, including body text and attachment info.

Get all messages in an email thread by thread ID.

Compose and send a new email.

Reply to an existing email. Automatically sets In-Reply-To and References headers and keeps the thread.

Forward an existing email to new recipients, optionally adding a note above the original message.

Create a draft email (not sent). Optionally attach it to an existing thread for a draft reply.

Modify a single email: add/remove labels, mark as read/unread, archive, or move to trash.

Apply the same label modifications to multiple emails at once (up to 1000 IDs).

Move an email to Trash (recoverable for 30 days).

Restore an email from Trash back to the inbox.

Move multiple emails to Trash at once by adding the TRASH label and removing INBOX.

Mark one or more emails as spam (moves to Spam folder).

Search emails with multiple criteria and optionally apply a bulk action to all matching results. Useful for inbox cleanup, bulk labeling, or archiving by rule.

List all Gmail labels (system and user-created), including their IDs needed for modify operations.

Create a new Gmail label (folder).

Delete a user-created Gmail label. System labels (INBOX, SENT, etc.) cannot be deleted.

Extract unique email addresses from messages matching a Gmail query. Useful for building contact lists.

Re-format and filter a list of email objects (previously fetched) into a custom structure. Supports field selection, filtering by field value, and sorting.

Download an email attachment by message ID and attachment ID. Returns base64-encoded content with metadata. Use get_email first to find attachment IDs.

Get the authenticated user's Gmail profile: email address, total messages, total threads, and history ID.

Analyze recent sent emails to find your most frequently contacted email addresses. No extra API scope needed.