Gmail

gmail_list_messages

List messages in the mailbox. Supports Gmail search syntax for filtering (e.g., from:, to:, subject:, is:unread, has:attachment).

Remote node2flow/gmail-mcp

Other tools also called gmail_list_messages? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Gmail search query (e.g., \"from:[email protected] is:unread\", \"subject:meeting has:attachment\", \"after:2026/01/01\")"
    },
    "label_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by label IDs (e.g., [\"INBOX\"], [\"UNREAD\"]). System labels: INBOX, SENT, DRAFT, SPAM, TRASH, UNREAD, STARRED, IMPORTANT"
    },
    "page_token": {
      "type": "string",
      "description": "Token for next page of results (from previous response nextPageToken)"
    },
    "max_results": {
      "type": "number",
      "description": "Maximum number of messages to return (default: 100, max: 500)"
    },
    "include_spam_trash": {
      "type": "boolean",
      "description": "Include messages from SPAM and TRASH (default: false)"
    }
  }
}
          

Provider

Gmail →