Gmail

Move a message to the trash. Args: - messageId: The ID of the message to trash Returns: The trashed message.

Restore a message from the trash. Args: - messageId: The ID of the message to restore Returns: The restored message.

Permanently delete a message. This action cannot be undone. Args: - messageId: The ID of the message to delete Returns: Confirmation of deletion.

Permanently delete multiple messages at once. This action cannot be undone. Args: - ids: List of message IDs to delete Returns: Confirmation of batch deletion.

Add a new forwarding address. Requires verification. Args: - email: The email address to add Returns: The created forwarding address (pending verification).

Delete a forwarding address. Args: - email: The forwarding email address to delete Returns: Confirmation of deletion.

Get the current user's Gmail profile. Returns: Profile information including email address, total messages, total threads, and the current history ID (useful for tracking changes).

Get auto-forwarding settings. Returns: Current auto-forwarding settings.

Update Gmail display language. Args: - displayLanguage: BCP 47 language tag (e.g., 'en', 'es', 'fr', 'de') Returns: Updated language settings.

List all send-as aliases. Returns: List of send-as aliases with their settings.

Get an attachment from a message. The attachment data is returned as base64url encoded. You can find the attachmentId in the message payload when getting a message with format 'full'. Args: - messageId: The ID of the message containing the attachment - attachmentId: The ID of the attachment to retrieve - format: Response format ('json' or 'markdown') Returns: The attachment data (base64url encoded) and size.

List drafts in the user's mailbox. Args: - query: Search query (Gmail search syntax) - maxResults: Maximum number of drafts to return (1-500, default: 20) - pageToken: Token for pagination from previous response - includeSpamTrash: Include drafts from SPAM and TRASH - format: Response format ('json' or 'markdown') Returns: Paginated list of drafts with IDs and associated message info.

Get a specific draft by ID. Args: - draftId: The ID of the draft to retrieve - format: Message format ('minimal', 'full', 'raw', 'metadata') - responseFormat: Response format ('json' or 'markdown') Returns: The draft with its message content.

Create a new draft email. Args: - to: Recipient email address(es) - subject: Email subject - body: Email body (HTML supported) - cc: CC recipients (optional) - bcc: BCC recipients (optional) - threadId: Thread ID for reply drafts (optional) Returns: The created draft.

Update an existing draft (replaces the content). Args: - draftId: The ID of the draft to update - to: Recipient email address(es) - subject: Email subject - body: Email body (HTML supported) - cc: CC recipients (optional) - bcc: BCC recipients (optional) Returns: The updated draft.

Send an existing draft. Args: - draftId: The ID of the draft to send Returns: The sent message.

Delete a draft. This action cannot be undone. Args: - draftId: The ID of the draft to delete Returns: Confirmation of deletion.

List the history of changes to the mailbox. Use this to track changes since a known point in time. Get the startHistoryId from a previous message, thread, or profile response. Args: - startHistoryId: Required. Returns history records after this ID - maxResults: Maximum number of history records to return (1-500) - pageToken: Token for pagination from previous response - labelId: Only return messages with this label - historyTypes: Types of history to return (messageAdded, messageDeleted, labelAdded, labelRemoved) - format: Response format ('json' or 'markdown') Returns: List of history records showing changes since the start history ID.

List all labels in the user's mailbox. Args: - format: Response format ('json' or 'markdown') Returns: List of all labels with their IDs, names, types, and message counts.

Get a specific label by ID. Args: - labelId: The ID of the label (e.g., "INBOX", "STARRED", or custom label ID) - format: Response format ('json' or 'markdown') Returns: The label with all details including message and thread counts.

Create a new label. Args: - name: The display name of the label - labelListVisibility: Visibility in label list ('labelShow', 'labelShowIfUnread', 'labelHide') - messageListVisibility: Visibility in message list ('show', 'hide') - backgroundColor: Background color in hex (e.g., "#16a765") - textColor: Text color in hex (e.g., "#ffffff") Returns: The created label.

Update a label (full replacement). Args: - labelId: The ID of the label to update - name: New display name - labelListVisibility: Visibility in label list - messageListVisibility: Visibility in message list - backgroundColor: Background color in hex - textColor: Text color in hex Returns: The updated label.

Partially update a label (only specified fields). Args: - labelId: The ID of the label to patch - name: New display name (optional) - labelListVisibility: Visibility in label list (optional) - messageListVisibility: Visibility in message list (optional) - backgroundColor: Background color in hex (optional) - textColor: Text color in hex (optional) Returns: The patched label.

Delete a label. System labels cannot be deleted. Args: - labelId: The ID of the label to delete Returns: Confirmation of deletion.

List messages in the user's mailbox with optional filtering. Args: - query: Search query (Gmail search syntax, e.g., "from:sender@example.com", "is:unread", "subject:hello") - maxResults: Maximum number of messages to return (1-500, default: 20) - pageToken: Token for pagination from previous response - labelIds: Only return messages with these label IDs (e.g., ["INBOX", "UNREAD"]) - includeSpamTrash: Include messages from SPAM and TRASH (default: false) - format: Response format ('json' or 'markdown') Returns: Paginated list of messages with IDs and thread IDs.

Get a specific message by ID. Args: - messageId: The ID of the message to retrieve - format: Message format ('minimal', 'full', 'raw', 'metadata') - minimal: Only id and labels - full: Full message with parsed payload (default) - raw: Full message in base64url encoded raw format - metadata: Only metadata headers - responseFormat: Response format ('json' or 'markdown') Returns: The message with requested format and details.

Send an email message. Args: - to: Recipient email address(es), comma-separated for multiple - subject: Email subject - body: Email body (HTML supported) - cc: CC recipients, comma-separated (optional) - bcc: BCC recipients, comma-separated (optional) - threadId: Thread ID to reply to (optional, for threading) - inReplyTo: Message-ID header of the message being replied to (optional) - references: References header for threading (optional) Returns: The sent message with ID and thread ID.

Modify the labels on a message. Args: - messageId: The ID of the message to modify - addLabelIds: List of label IDs to add (e.g., ["STARRED", "IMPORTANT"]) - removeLabelIds: List of label IDs to remove (e.g., ["UNREAD"]) Returns: The modified message.

Modify labels on multiple messages at once. Args: - ids: List of message IDs to modify - addLabelIds: List of label IDs to add to all messages - removeLabelIds: List of label IDs to remove from all messages Returns: Confirmation of batch modification.

Set up push notifications for mailbox changes. This sets up a watch on the user's mailbox. When changes occur, notifications are sent to the specified Cloud Pub/Sub topic. Args: - topicName: Cloud Pub/Sub topic name (e.g., "projects/myproject/topics/mytopic") - labelIds: Only notify about messages with these labels (optional) - labelFilterAction: How to use labelIds - 'include' or 'exclude' (default: include) Returns: Watch response with historyId and expiration time.

Stop receiving push notifications for mailbox changes. This stops any existing watch on the user's mailbox. Returns: Confirmation that notifications have been stopped.

Get vacation auto-reply settings. Returns: Current vacation settings including enabled status, response text, and date range.

Update vacation auto-reply settings. Args: - enableAutoReply: Whether to enable auto-reply - responseSubject: Subject line for auto-reply - responseBodyPlainText: Plain text body for auto-reply - responseBodyHtml: HTML body for auto-reply - restrictToContacts: Only reply to contacts - restrictToDomain: Only reply to same domain - startTime: Start time (epoch milliseconds) - endTime: End time (epoch milliseconds) Returns: Updated vacation settings.

List all message filters. Returns: List of all filters with their criteria and actions.

Get a specific filter by ID. Args: - filterId: The ID of the filter Returns: The filter with criteria and action details.

Create a new message filter. Args: Criteria (at least one required): - from: Sender address to match - to: Recipient address to match - subject: Subject to match - query: General search query - negatedQuery: Query for messages NOT to match - hasAttachment: Whether message has attachments - excludeChats: Exclude chat messages - size: Size in bytes - sizeComparison: 'larger' or 'smaller' Actions (at least one required): - addLabelIds: Labels to add - removeLabelIds: Labels to remove - forward: Email to forward to Returns: The created filter.

Delete a message filter. Args: - filterId: The ID of the filter to delete Returns: Confirmation of deletion.

List all forwarding addresses. Returns: List of forwarding addresses with verification status.

Get a specific forwarding address. Args: - email: The forwarding email address Returns: The forwarding address with verification status.

Update auto-forwarding settings. Args: - enabled: Enable/disable auto-forwarding - emailAddress: Address to forward to (must be verified) - disposition: What to do with forwarded messages ('leaveInInbox', 'archive', 'trash', 'markRead') Returns: Updated auto-forwarding settings.

Get a specific send-as alias. Args: - email: The send-as email address Returns: The send-as alias settings.

Create a new send-as alias. Requires verification. Args: - sendAsEmail: The email address - displayName: Display name for the alias - replyToAddress: Reply-to address - signature: Email signature (HTML) - treatAsAlias: Whether to treat as alias Returns: The created send-as alias (may require verification).

Update a send-as alias. Args: - email: The send-as email to update - displayName: New display name - replyToAddress: New reply-to address - signature: New signature (HTML) - treatAsAlias: Whether to treat as alias - isDefault: Make this the default send-as Returns: The updated send-as alias.

Delete a send-as alias. Args: - email: The send-as email to delete Returns: Confirmation of deletion.

Send a verification email for a send-as alias. Args: - email: The send-as email to verify Returns: Confirmation that verification email was sent.

List all delegates who have access to this account. Returns: List of delegates with their email and verification status.

Get a specific delegate. Args: - email: The delegate email address Returns: The delegate with verification status.

Add a delegate to this account. Requires verification. Args: - email: The email of the person to add as delegate Returns: The created delegate (pending verification).

Remove a delegate from this account. Args: - email: The delegate email to remove Returns: Confirmation of removal.

Get IMAP access settings. Returns: Current IMAP settings.

Update IMAP access settings. Args: - enabled: Enable/disable IMAP - autoExpunge: Auto-expunge on delete - expungeBehavior: What to do on expunge ('archive', 'trash', 'deleteForever') - maxFolderSize: Maximum folder size Returns: Updated IMAP settings.

Get POP access settings. Returns: Current POP settings.

Update POP access settings. Args: - accessWindow: Message access window ('disabled', 'fromNowOn', 'allMail') - disposition: What to do after POP download ('leaveInInbox', 'archive', 'trash', 'markRead') Returns: Updated POP settings.

Get Gmail display language settings. Returns: Current language settings.

List email threads in the user's mailbox with optional filtering. Args: - query: Search query (Gmail search syntax) - maxResults: Maximum number of threads to return (1-500, default: 20) - pageToken: Token for pagination from previous response - labelIds: Only return threads with these label IDs - includeSpamTrash: Include threads from SPAM and TRASH (default: false) - format: Response format ('json' or 'markdown') Returns: Paginated list of threads with IDs and snippets.

Get a specific thread with all its messages. Args: - threadId: The ID of the thread to retrieve - format: Message format ('minimal', 'full', 'raw', 'metadata') - responseFormat: Response format ('json' or 'markdown') Returns: The thread with all messages.

Modify the labels on all messages in a thread. Args: - threadId: The ID of the thread to modify - addLabelIds: List of label IDs to add - removeLabelIds: List of label IDs to remove Returns: The modified thread.

Move a thread and all its messages to the trash. Args: - threadId: The ID of the thread to trash Returns: The trashed thread.

Restore a thread and all its messages from the trash. Args: - threadId: The ID of the thread to restore Returns: The restored thread.

Permanently delete a thread and all its messages. This action cannot be undone. Args: - threadId: The ID of the thread to delete Returns: Confirmation of deletion.