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 | Default |
---|---|---|---|
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 |