Email: Search Tool

Usage

All Portia tools using API endpoints that require OAuth are built with plug and play authentication support. They use Portia client credentials including client ID, client name and redirect URL. Such tools will raise a Action Clarification with an OAuth link as the action URL. The portia.wait_for_ready() method must be used in this scenario: Portia's OAuth server will listen for the authentication result and resolve the concerned clarification, allowing your plan run to resume again.

For more on this, please visit to the section on running Portia tools (↗).

Tool details

Tool ID: portia:google:gmail:search_email

Tool description: Searches for emails in the user's inbox and

Args schema:

{
  "description": "Input for SearchEmailTool.",
  "properties": {
    "query": {
      "description": "The query to search for emails. This supports Gmail search syntax (e.g. 'from:jane@acme.com' or 'subject:meeting').",
      "title": "Query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "SearchEmailToolSchema",
  "type": "object"
}

Output schema:

('list[dict[str, str]]', 'list[dict[str, str]]: List of emails with the following keys: from, to, subject, date, body.')