Gmail

Gmail MCP Server for Cloudflare Workers

Available Tools

60 tools available in the Gmail MCP server. Each tool can be called by AI assistants to perform specific actions.

gmail_trash_message

Move a message to the trash.

Args:

messageId: The ID of the message to trash

Returns: The trashed message.

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

gmail_untrash_message

Restore a message from the trash.

Args:

messageId: The ID of the message to restore

Returns: The restored message.

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

gmail_delete_message

Permanently delete a message. This action cannot be undone.

Args:

messageId: The ID of the message to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

gmail_batch_delete_messages

Permanently delete multiple messages at once. This action cannot be undone.

Args:

ids: List of message IDs to delete

Returns: Confirmation of batch deletion.

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Message IDs to delete"
    }
  }
}

gmail_create_forwarding_address

Add a new forwarding address. Requires verification.

Args:

email: The email address to add

Returns: The created forwarding address (pending verification).

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email to add"
    }
  }
}

gmail_delete_forwarding_address

Delete a forwarding address.

Args:

email: The forwarding email address to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Forwarding email"
    }
  }
}

gmail_get_profile

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

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_auto_forwarding

Get auto-forwarding settings.

Returns: Current auto-forwarding settings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_update_language_settings

Update Gmail display language.

Args:

displayLanguage: BCP 47 language tag (e.g., 'en', 'es', 'fr', 'de')

Returns: Updated language settings.

{
  "type": "object",
  "required": [
    "displayLanguage"
  ],
  "properties": {
    "displayLanguage": {
      "type": "string",
      "description": "Language code (BCP 47)"
    }
  }
}

gmail_list_send_as

List all send-as aliases.

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

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_attachment

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.

{
  "type": "object",
  "required": [
    "messageId",
    "attachmentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "attachmentId": {
      "type": "string",
      "description": "Attachment ID"
    }
  }
}

gmail_list_drafts

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Gmail search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum drafts to return"
    },
    "includeSpamTrash": {
      "type": "boolean",
      "default": false,
      "description": "Include SPAM and TRASH"
    }
  }
}

gmail_get_draft

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.

{
  "type": "object",
  "required": [
    "draftId"
  ],
  "properties": {
    "format": {
      "enum": [
        "minimal",
        "full",
        "raw",
        "metadata"
      ],
      "type": "string",
      "default": "full",
      "description": "Message format"
    },
    "draftId": {
      "type": "string",
      "description": "Draft ID"
    },
    "responseFormat": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_create_draft

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.

{
  "type": "object",
  "required": [
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "cc": {
      "type": "string",
      "description": "CC recipients"
    },
    "to": {
      "type": "string",
      "description": "Recipient email address(es)"
    },
    "bcc": {
      "type": "string",
      "description": "BCC recipients"
    },
    "body": {
      "type": "string",
      "description": "Email body (HTML supported)"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "threadId": {
      "type": "string",
      "description": "Thread ID for reply drafts"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "draftId"
  ],
  "properties": {
    "cc": {
      "type": "string",
      "description": "CC recipients"
    },
    "to": {
      "type": "string",
      "description": "Recipient email address(es)"
    },
    "bcc": {
      "type": "string",
      "description": "BCC recipients"
    },
    "body": {
      "type": "string",
      "description": "Email body"
    },
    "draftId": {
      "type": "string",
      "description": "Draft ID"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    }
  }
}

gmail_send_draft

Send an existing draft.

Args:

draftId: The ID of the draft to send

Returns: The sent message.

{
  "type": "object",
  "required": [
    "draftId"
  ],
  "properties": {
    "draftId": {
      "type": "string",
      "description": "Draft ID"
    }
  }
}

gmail_delete_draft

Delete a draft. This action cannot be undone.

Args:

draftId: The ID of the draft to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "draftId"
  ],
  "properties": {
    "draftId": {
      "type": "string",
      "description": "Draft ID"
    }
  }
}

gmail_list_history

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.

{
  "type": "object",
  "required": [
    "startHistoryId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "labelId": {
      "type": "string",
      "description": "Filter by label ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum records to return"
    },
    "historyTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "History types to return"
    },
    "startHistoryId": {
      "type": "string",
      "description": "Start history ID (required)"
    }
  }
}

gmail_list_labels

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.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_label

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.

{
  "type": "object",
  "required": [
    "labelId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "labelId": {
      "type": "string",
      "description": "Label ID"
    }
  }
}

gmail_create_label

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.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Label name"
    },
    "textColor": {
      "type": "string",
      "description": "Text color in hex"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Background color in hex"
    },
    "labelListVisibility": {
      "enum": [
        "labelShow",
        "labelShowIfUnread",
        "labelHide"
      ],
      "type": "string",
      "description": "Visibility in label list"
    },
    "messageListVisibility": {
      "enum": [
        "show",
        "hide"
      ],
      "type": "string",
      "description": "Visibility in message list"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "labelId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New label name"
    },
    "labelId": {
      "type": "string",
      "description": "Label ID"
    },
    "textColor": {
      "type": "string",
      "description": "Text color in hex"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Background color in hex"
    },
    "labelListVisibility": {
      "enum": [
        "labelShow",
        "labelShowIfUnread",
        "labelHide"
      ],
      "type": "string",
      "description": "Visibility in label list"
    },
    "messageListVisibility": {
      "enum": [
        "show",
        "hide"
      ],
      "type": "string",
      "description": "Visibility in message list"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "labelId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New label name"
    },
    "labelId": {
      "type": "string",
      "description": "Label ID"
    },
    "textColor": {
      "type": "string"
    },
    "backgroundColor": {
      "type": "string"
    },
    "labelListVisibility": {
      "enum": [
        "labelShow",
        "labelShowIfUnread",
        "labelHide"
      ],
      "type": "string"
    },
    "messageListVisibility": {
      "enum": [
        "show",
        "hide"
      ],
      "type": "string"
    }
  }
}

gmail_delete_label

Delete a label. System labels cannot be deleted.

Args:

labelId: The ID of the label to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "labelId"
  ],
  "properties": {
    "labelId": {
      "type": "string",
      "description": "Label ID"
    }
  }
}

gmail_list_messages

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Gmail search query (e.g., \"is:unread\", \"from:user@example.com"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by label IDs"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token from previous response"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum messages to return"
    },
    "includeSpamTrash": {
      "type": "boolean",
      "default": false,
      "description": "Include SPAM and TRASH messages"
    }
  }
}

gmail_get_message

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.

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "minimal",
        "full",
        "raw",
        "metadata"
      ],
      "type": "string",
      "default": "full",
      "description": "Message format"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "responseFormat": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_send_message

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.

{
  "type": "object",
  "required": [
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "cc": {
      "type": "string",
      "description": "CC recipients"
    },
    "to": {
      "type": "string",
      "description": "Recipient email address(es)"
    },
    "bcc": {
      "type": "string",
      "description": "BCC recipients"
    },
    "body": {
      "type": "string",
      "description": "Email body (HTML supported)"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "threadId": {
      "type": "string",
      "description": "Thread ID for replies"
    },
    "inReplyTo": {
      "type": "string",
      "description": "Message-ID of message being replied to"
    },
    "references": {
      "type": "string",
      "description": "References header for threading"
    }
  }
}

gmail_modify_message

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.

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "addLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to add"
    },
    "removeLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to remove"
    }
  }
}

gmail_batch_modify_messages

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.

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Message IDs to modify"
    },
    "addLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to add"
    },
    "removeLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to remove"
    }
  }
}

gmail_watch

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.

{
  "type": "object",
  "required": [
    "topicName"
  ],
  "properties": {
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to filter notifications"
    },
    "topicName": {
      "type": "string",
      "description": "Cloud Pub/Sub topic name"
    },
    "labelFilterAction": {
      "enum": [
        "include",
        "exclude"
      ],
      "type": "string",
      "default": "include",
      "description": "How to filter by labels"
    }
  }
}

gmail_stop

Stop receiving push notifications for mailbox changes.

This stops any existing watch on the user's mailbox.

Returns: Confirmation that notifications have been stopped.

{
  "type": "object",
  "properties": {}
}

gmail_get_vacation_settings

Get vacation auto-reply settings.

Returns: Current vacation settings including enabled status, response text, and date range.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_update_vacation_settings

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.

{
  "type": "object",
  "required": [
    "enableAutoReply"
  ],
  "properties": {
    "endTime": {
      "type": "string",
      "description": "End time (epoch ms)"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (epoch ms)"
    },
    "enableAutoReply": {
      "type": "boolean",
      "description": "Enable auto-reply"
    },
    "responseSubject": {
      "type": "string",
      "description": "Auto-reply subject"
    },
    "responseBodyHtml": {
      "type": "string",
      "description": "HTML response"
    },
    "restrictToDomain": {
      "type": "boolean",
      "description": "Only reply to same domain"
    },
    "restrictToContacts": {
      "type": "boolean",
      "description": "Only reply to contacts"
    },
    "responseBodyPlainText": {
      "type": "string",
      "description": "Plain text response"
    }
  }
}

gmail_list_filters

List all message filters.

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

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_filter

Get a specific filter by ID.

Args:

filterId: The ID of the filter

Returns: The filter with criteria and action details.

{
  "type": "object",
  "required": [
    "filterId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    }
  }
}

gmail_create_filter

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.

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Match recipient"
    },
    "from": {
      "type": "string",
      "description": "Match sender"
    },
    "size": {
      "type": "number",
      "description": "Size in bytes"
    },
    "query": {
      "type": "string",
      "description": "General query"
    },
    "forward": {
      "type": "string",
      "description": "Forward to email"
    },
    "subject": {
      "type": "string",
      "description": "Match subject"
    },
    "addLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Labels to add"
    },
    "excludeChats": {
      "type": "boolean",
      "description": "Exclude chats"
    },
    "negatedQuery": {
      "type": "string",
      "description": "Negated query"
    },
    "hasAttachment": {
      "type": "boolean",
      "description": "Has attachments"
    },
    "removeLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Labels to remove"
    },
    "sizeComparison": {
      "enum": [
        "larger",
        "smaller"
      ],
      "type": "string",
      "description": "Size comparison"
    }
  }
}

gmail_delete_filter

Delete a message filter.

Args:

filterId: The ID of the filter to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "filterId"
  ],
  "properties": {
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    }
  }
}

gmail_list_forwarding_addresses

List all forwarding addresses.

Returns: List of forwarding addresses with verification status.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_forwarding_address

Get a specific forwarding address.

Args:

email: The forwarding email address

Returns: The forwarding address with verification status.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Forwarding email"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_update_auto_forwarding

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.

{
  "type": "object",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Enable auto-forwarding"
    },
    "disposition": {
      "enum": [
        "leaveInInbox",
        "archive",
        "trash",
        "markRead"
      ],
      "type": "string",
      "description": "Message disposition"
    },
    "emailAddress": {
      "type": "string",
      "description": "Forward to address"
    }
  }
}

gmail_get_send_as

Get a specific send-as alias.

Args:

email: The send-as email address

Returns: The send-as alias settings.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Send-as email"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_create_send_as

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

{
  "type": "object",
  "required": [
    "sendAsEmail"
  ],
  "properties": {
    "signature": {
      "type": "string",
      "description": "Email signature (HTML)"
    },
    "displayName": {
      "type": "string",
      "description": "Display name"
    },
    "sendAsEmail": {
      "type": "string",
      "description": "Send-as email"
    },
    "treatAsAlias": {
      "type": "boolean",
      "description": "Treat as alias"
    },
    "replyToAddress": {
      "type": "string",
      "description": "Reply-to address"
    }
  }
}

gmail_update_send_as

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.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Send-as email to update"
    },
    "isDefault": {
      "type": "boolean",
      "description": "Make default"
    },
    "signature": {
      "type": "string",
      "description": "Email signature (HTML)"
    },
    "displayName": {
      "type": "string",
      "description": "Display name"
    },
    "treatAsAlias": {
      "type": "boolean",
      "description": "Treat as alias"
    },
    "replyToAddress": {
      "type": "string",
      "description": "Reply-to address"
    }
  }
}

gmail_delete_send_as

Delete a send-as alias.

Args:

email: The send-as email to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Send-as email"
    }
  }
}

gmail_verify_send_as

Send a verification email for a send-as alias.

Args:

email: The send-as email to verify

Returns: Confirmation that verification email was sent.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Send-as email"
    }
  }
}

gmail_list_delegates

List all delegates who have access to this account.

Returns: List of delegates with their email and verification status.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_get_delegate

Get a specific delegate.

Args:

email: The delegate email address

Returns: The delegate with verification status.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Delegate email"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_create_delegate

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

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Delegate email"
    }
  }
}

gmail_delete_delegate

Remove a delegate from this account.

Args:

email: The delegate email to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Delegate email"
    }
  }
}

gmail_get_imap_settings

Get IMAP access settings.

Returns: Current IMAP settings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Enable IMAP"
    },
    "autoExpunge": {
      "type": "boolean",
      "description": "Auto-expunge"
    },
    "maxFolderSize": {
      "type": "number",
      "description": "Max folder size"
    },
    "expungeBehavior": {
      "enum": [
        "archive",
        "trash",
        "deleteForever"
      ],
      "type": "string",
      "description": "Expunge behavior"
    }
  }
}

gmail_get_pop_settings

Get POP access settings.

Returns: Current POP settings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "disposition": {
      "enum": [
        "leaveInInbox",
        "archive",
        "trash",
        "markRead"
      ],
      "type": "string",
      "description": "Disposition"
    },
    "accessWindow": {
      "enum": [
        "disabled",
        "fromNowOn",
        "allMail"
      ],
      "type": "string",
      "description": "Access window"
    }
  }
}

gmail_get_language_settings

Get Gmail display language settings.

Returns: Current language settings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_list_threads

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Gmail search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by label IDs"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 20,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum threads to return"
    },
    "includeSpamTrash": {
      "type": "boolean",
      "default": false,
      "description": "Include SPAM and TRASH"
    }
  }
}

gmail_get_thread

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.

{
  "type": "object",
  "required": [
    "threadId"
  ],
  "properties": {
    "format": {
      "enum": [
        "minimal",
        "full",
        "raw",
        "metadata"
      ],
      "type": "string",
      "default": "full",
      "description": "Message format"
    },
    "threadId": {
      "type": "string",
      "description": "Thread ID"
    },
    "responseFormat": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

gmail_modify_thread

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.

{
  "type": "object",
  "required": [
    "threadId"
  ],
  "properties": {
    "threadId": {
      "type": "string",
      "description": "Thread ID"
    },
    "addLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to add"
    },
    "removeLabelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Label IDs to remove"
    }
  }
}

gmail_trash_thread

Move a thread and all its messages to the trash.

Args:

threadId: The ID of the thread to trash

Returns: The trashed thread.

{
  "type": "object",
  "required": [
    "threadId"
  ],
  "properties": {
    "threadId": {
      "type": "string",
      "description": "Thread ID"
    }
  }
}

gmail_untrash_thread

Restore a thread and all its messages from the trash.

Args:

threadId: The ID of the thread to restore

Returns: The restored thread.

{
  "type": "object",
  "required": [
    "threadId"
  ],
  "properties": {
    "threadId": {
      "type": "string",
      "description": "Thread ID"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "threadId"
  ],
  "properties": {
    "threadId": {
      "type": "string",
      "description": "Thread ID"
    }
  }
}