Skip to main content
List email message IDs from inbox. Use get-email to fetch full content for each message.

Tool details

FieldValue
Namegmail:list-emails
GroupIntegrations

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "maxResults": {
      "type": "number",
      "description": "Maximum number of messages to return (1-500)"
    },
    "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)"
    },
    "end_user_id": {
      "type": "string",
      "description": "End-user ID for per-user OAuth token resolution"
    }
  },
  "description": "Input schema for the gmail:list-emails tool."
}

Output schema

This tool does not publish an output schema.