Gmail

search_messages

Search a mailbox folder by free text and/or structured filters (from, to, subject, body, date range, attachments). At least one filter is required. Returns message summaries with uids.

Remote faivelo/mail

Remote (network-hosted)

Other tools also called search_messages? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text query (searches headers and body)"
    },
    "to": {
      "type": "string",
      "description": "Match recipient"
    },
    "body": {
      "type": "string",
      "description": "Match body text"
    },
    "from": {
      "type": "string",
      "description": "Match sender"
    },
    "folder": {
      "type": "string",
      "description": "IMAP folder name (default \"INBOX\")"
    },
    "mailbox": {
      "type": "string",
      "description": "Full mailbox address, e.g. \"[email protected]\""
    },
    "subject": {
      "type": "string",
      "description": "Match subject"
    },
    "dateAfter": {
      "type": "string",
      "description": "Only messages after this date (ISO 8601)"
    },
    "dateBefore": {
      "type": "string",
      "description": "Only messages before this date (ISO 8601)"
    },
    "hasAttachment": {
      "type": "boolean",
      "description": "Only messages with attachments"
    }
  }
}
          

Provider

Gmail →