Gmail Reader

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Node Inputs

• Label: The Gmail label to read from (default: ‘INBOX’)
• Number of Emails: Maximum number of emails to process. Leave blank to read all emails.

​

Optional Settings

• Search Query: Optional Gmail search syntax to filter emails
• Mark as Read: Whether to mark processed emails as read (default: False)
• Ignore Read Status: If checked, this will include both unread and previously read emails in your search. By default, only unread emails are processed
• Read Full Thread: If checked, the full message chain will be read for each email thread (default: False)

​

Date Range Filtering

• Use Dates?: Enable this toggle to filter emails by time period
• Date Range: Choose from preset ranges for quick filtering:
  • Last 24 Hours
  • Last Week
  • Last Month
  • Last 3 Months
  • Last 6 Months
• Use Exact Dates?: Toggle this option to specify custom date ranges
  • When enabled, you can set precise Start and End dates
  • When disabled, the preset Date Range selection is used
• Start Date (UTC): The beginning of your custom date range (only available when Use Exact Dates is enabled)
• End Date (UTC): The end of your custom date range (only available when Use Exact Dates is enabled)

• Historical email analysis
• Periodic reporting
• Retrieving emails from specific events or timeframes
• Automating regular email processing batches

Note: When “Use Exact Dates?” is enabled, you can expose the Start Date and End Date parameters through “Configure Inputs” and connect them directly to the Datetime node for dynamic date ranges.

​

Node Output

• Email Bodies: Content of the email messages
• Attached File Names: Attached file object

Note that multiple attachments are separated by a comma, eg: PDF1, PDF2. You can use the Split Text node here to output a list with each file.

• Message ID: Unique ID of each individual email
• Thread ID: Unique ID of the entire conversation thread that can contain multiple emails
• Sender Addresses: Email addresses of senders
• Recipient Addresses: All recipients (including CC/BCC)
• Subjects: Email subject lines
• Dates: Date & timestamp of emails (in UTC)
• Sender Display Names: Names of the email sender

​

Understanding Attachment Handling

​

Multiple Attachments per Email

Example output: "document1.pdf, spreadsheet.xlsx, image.png"

Gmail Reader → Split Text (separator: ", ") → PDF Reader (Loop Mode)

​

Node Functionality

• Support for Gmail search syntax filtering
• Date-based email filtering
• Attachment handling
• Customizable email processing options
• Secure authentication with Gumloop

​

Trigger Functionality

​

How the Gmail trigger works

• A new email arrives in the configured label, or
• An existing email gains the configured label after delivery (e.g. via a Gmail filter or manual labeling).

• Multiple triggers, multiple labels — you can configure multiple Gmail triggers on the same account, each watching a different label. There is no per-account label limit.
• Read status is not a filter — the trigger fires whether or not you’ve opened the email in your Gmail UI between when it arrived and when the next poll runs.
• Latency — emails are detected within ~30 seconds median, ~60 seconds worst case.
• Cost — polls with no new email do minimal work (one Gmail API call) and don’t run your workflow.

​

Trigger parameters

• Label — the Gmail label to watch (use Inbox for the general inbox).
• Mark as Read? — whether to mark each fired email as read after processing.
• Read as HTML? — read the body as HTML instead of plain text.

​

When To Use

• Customer Support: Automatically process incoming support emails
• Data Extraction: Extract information from scheduled reports
• Email Monitoring: Track important communications
• Attachment Processing: Handle incoming file attachments

• Processing order confirmations
• Collecting daily reports
• Monitoring support tickets
• Archiving attachments

​

Example Workflows

​

1. Weekly Email Report Processing

Current DateTime → Gmail Reader → Ask AI → Google Sheets Writer
Setup:
- Use Dates?: Yes
- Use Exact Dates?: Yes
- Start Date: Connected to Current DateTime with -7 days modifier
- End Date: Connected to Current DateTime
Purpose: Generate weekly summary of important emails

​

2. Monthly Invoice Collection

Gmail Reader → PDF Reader → Extract Data → Airtable Writer
Setup:
- Label: Invoices
- Date Range: Last Month
- Search Query: has:attachment filename:pdf
Purpose: Extract and store monthly invoice data

​

3. Daily Support Email Categorization

Gmail Reader [Trigger] → Categorizer → Slack Message Sender
Setup:
- Label: Support
- Mark as Read?: Yes (prevents the same email being re-surfaced
  by downstream tooling that checks unread status)
Purpose: Classify and route incoming support requests as they arrive.

​

Important Considerations:

1. Requires Authentication with Gmail - Set up in the Credentials page
2. Manual mode processes only unread emails by default. Toggle Ignore Read Status under Show More Options to include read emails. Trigger mode fires on new emails regardless of read status — see “How the Gmail trigger works” above.
3. Output types change to single string if reading just one email
4. Date filtering in UTC timezone may not match your local time