search_gmail_messages
Search Gmail messages using queries with standard operators to find specific emails, returning message and thread IDs with web links for verification.
Instructions
Searches messages in a user's Gmail account based on a query. Returns both Message IDs and Thread IDs for each found message, along with Gmail web interface links for manual verification. Supports pagination via page_token parameter.
Args: query (str): The search query. Supports standard Gmail search operators. user_google_email (str): The user's Google email address. Required. page_size (int): The maximum number of messages to return. Defaults to 10. page_token (Optional[str]): Token for retrieving the next page of results. Use the next_page_token from a previous response.
Returns: str: LLM-friendly structured results with Message IDs, Thread IDs, and clickable Gmail web interface URLs for each found message. Includes pagination token if more results are available.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| user_google_email | Yes | ||
| page_size | No | ||
| page_token | No |