Search Gmail Emails
Automatically search and retrieve emails from Gmail using criteria, streamlining email-based workflows in FlowHunt.

Component description
How the Search Gmail Emails component works
Search Emails Component
The Search Emails component is designed to help you find and retrieve emails from Gmail based on specified search criteria. This component is particularly useful within AI workflows where automated email processing, filtering, or information extraction is required.
What Does This Component Do?
This component allows you to perform a search over your Gmail inbox, returning a list of emails that match your defined criteria. It’s well-suited for scenarios where you need to automate the discovery, analysis, or summarization of emails, such as in virtual assistants, workflow automation, or data extraction pipelines.
Inputs
Field Name | Type | Description | Required | Default | Advanced |
---|---|---|---|---|---|
Criteria | String | The search string or criteria used to find relevant emails. | No | (empty) | No |
Max Results | Integer | The maximum number of emails to return from the search. | No | 10 | No |
Tool Description | Multiline | Description of the tool, providing guidance to agents on how to use this search capability. | No | (empty) | Yes |
Tool Name | String | A name to refer to this tool within agent-driven workflows. | No | (empty) | Yes |
Verbose | Boolean | If enabled, the component outputs more detailed information for debugging or transparency purposes. | No | false | Yes |
Key Input Details:
- Criteria: Accepts a search string similar to what you would use in Gmail (e.g.,
from:example@domain.com subject:"Invoice"
). - Max Results: Controls how many emails you want the component to fetch. It ranges from 0 to 30.
Outputs
Output Name | Type | Description |
---|---|---|
After Search Emails | Message | Contains the list of emails found from the search. |
Tool | Tool | Reference to the search tool itself. |
- After Search Emails: This is the primary output, delivering the results of your email search as a Message object.
- Tool: Provides access to the search tool for further integration or agent use.
Why Use This Component?
- Automated Email Processing: Perfect for extracting information from emails, organizing communications, or triggering other actions based on email content.
- Integration in AI Flows: Can be combined with other workflow components (like summarization, classification, or action triggers) to create smart, responsive systems.
- Customizable & Flexible: Search parameters (criteria and maximum results) are configurable, making the component adaptable to many different automation needs.
Example Use Cases
- Automatically finding and summarizing invoices in your inbox.
- Triggering alerts when specific emails arrive (e.g., emails from VIPs or containing urgent keywords).
- Extracting key information from customer support emails for further processing.
Summary Table
Feature | Benefit |
---|---|
Custom Criteria | Find exactly the emails you need |
Result Limiting | Control workflow performance and focus |
Agent Integration | Enhance AI workflows with email search capabilities |
Verbose Option | Debug or audit search operations as needed |
This component streamlines and automates the task of email searching, making it a powerful tool for anyone building intelligent, email-aware AI processes.
There are no examples of flow templates available at the moment using this component.
Frequently asked questions
- What does the Search Emails component do?
It allows you to search for emails in Gmail based on user-defined criteria, returning a list of emails that match your search.
- Can I limit the number of emails returned by a search?
Yes, you can set the maximum number of results to return, helping you control the amount of data processed.
- How can this component be used in a workflow?
You can automate processes that require fetching emails, such as ticketing systems, notifications, or follow-up sequences.
- Is this component only for Gmail?
Currently, this component is designed to work with Gmail email searches.
- What types of criteria can I use for searching?
You can specify keywords or other search parameters to filter emails according to your needs.
Try FlowHunt Search Emails
Enhance your workflows by integrating automated Gmail searches using the Search Emails component in FlowHunt.