Gmail

Download attachment data from a message by attachment ID. Returns binary data (base64url encoded), filename, MIME type, and size.

List all draft messages with pagination. Returns draft references with ID and snippet. Use get_draft for complete details.

Retrieve complete details of a specific draft by ID including message content, headers, recipients, and metadata.

Create a new draft message with recipients, subject, and body. Supports HTML, CC/BCC, attachments, and threading. Returns draft with ID.

Update an existing draft by replacing its content. Completely replaces draft’s message content. Returns updated draft.

Permanently delete a draft. Cannot be undone. Draft and content are permanently removed.

Send an existing draft immediately. Draft is sent as email and automatically deleted from drafts. Returns sent message with ID.

List all labels including system and custom labels. Returns name, type, visibility, message counts, and colors.

Retrieve detailed information about a specific label by ID including name, type, visibility, message counts, and colors.

Create a new custom label for organizing messages. Specify name, visibility settings, and optional colors. Returns created label with ID.

Update an existing label’s properties including name, visibility, and colors. Cannot modify system labels, only custom labels.

Permanently delete a custom label. Removes label from all messages. Cannot delete system labels. Cannot be undone.

List messages with search, filtering, and pagination. Supports Gmail query syntax (from:, to:, subject:, is:unread, etc.). Returns message references only.

Retrieve complete message details by ID including headers, body, attachments, labels, and metadata. Format options control detail level.

Send a new email with recipients, subject, and body. Supports HTML, CC/BCC, attachments, and threading. Returns sent message with ID and thread ID.

Add or remove labels from a message. Supports up to 100 label additions/removals per operation. Use system or custom label IDs.

Move message to TRASH (soft delete). Recoverable for 30 days. Message gets TRASH label and is removed from other folders.

Move multiple messages to trash in a single batch operation. More efficient than individual deletes.

Modify labels on multiple messages in a batch operation. Supports up to 100 label additions/removals. More efficient than individual modifications.

List conversation threads with search, filtering, and pagination. Supports Gmail query syntax. Returns thread references with ID and snippet.

Retrieve a complete conversation thread by ID including all messages in chronological order. Format options control detail level.

Add or remove labels from all messages in a thread simultaneously. Supports up to 100 label additions/removals. More efficient than modifying individual messages.

Move all messages in a thread to TRASH (soft delete). Recoverable for 30 days. More efficient than deleting individual messages.