list_messages

Retrieve and filter messages from a Gmail mailbox using optional parameters like label IDs, search queries, and result limits. Supports inclusion of spam/trash messages and HTML body content.

Instructions

List messages in the user's mailbox with optional filtering

Input Schema

Name	Required	Description
`includeBodyHtml`	No	Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large
`includeSpamTrash`	No	Include messages from SPAM and TRASH in the results
`labelIds`	No	Only return messages with labels that match all of the specified label IDs
`maxResults`	No	Maximum number of messages to return. Accepts values between 1-500
`pageToken`	No	Page token to retrieve a specific page of results
`q`	No	Only return messages matching the specified query. Supports the same query format as the Gmail search box

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "includeBodyHtml": {
      "description": "Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large",
      "type": "boolean"
    },
    "includeSpamTrash": {
      "description": "Include messages from SPAM and TRASH in the results",
      "type": "boolean"
    },
    "labelIds": {
      "description": "Only return messages with labels that match all of the specified label IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxResults": {
      "description": "Maximum number of messages to return. Accepts values between 1-500",
      "type": "number"
    },
    "pageToken": {
      "description": "Page token to retrieve a specific page of results",
      "type": "string"
    },
    "q": {
      "description": "Only return messages matching the specified query. Supports the same query format as the Gmail search box",
      "type": "string"
    }
  },
  "type": "object"
}

Gmail MCP

list_messages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Gmail MCP

Related Tools