Skip to main content
List Gmail message summaries with IDs, sender, recipient, subject, date, snippet, labels, and pagination tokens. Use get-email only when full message content is needed.

​
Tool details

FieldValue
Namegmail__list_emails
GroupIntegrations

​
Playground

​
Input schema

Input schema
{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "number",
      "description": "Maximum number of message summaries to return (1-50)"
    },
    "q": {
      "type": "string",
      "description": "Gmail search query (e.g. is:unread, from:user@example.com)"
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One label id item supplied to the tool."
      },
      "description": "Only return messages with these label IDs (e.g. INBOX, UNREAD)"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token for pagination"
    }
  },
  "description": "Input schema for the gmail__list_emails tool."
}

​
Output schema

This tool does not publish an output schema.