Skip to main content

Parse reference letters from Gmail with easybits and Google Sheets

Workflow preview

Workflow preview
100%
Parse reference letters from Gmail with easybits and Google Sheets preview
Open on n8n.io

1. Workflow Overview

Quick overview This workflow watches a Gmail label for reference check emails, extracts structured fields from attached reference letters using easybits Extractor, calculates a sentiment score, and...

Best for

  • HR automation workflows
  • AI Summarization automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

n8n-nodes-base.gmailtrigger, n8n-nodes-base.code, n8n-nodes-base.filter, n8n-nodes-base.splitinbatches, @easybits/n8n-nodes-extractor.easybitsextractor, n8n-nodes-base.googlesheets, n8n-nodes-base.gmail, n8n-nodes-base.stickynote

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by Felix.

Original n8n.io source

1.1 Workflow description

Title
Parse reference letters from Gmail with easybits and Google Sheets
Workflow name
Parse reference letters from Gmail with easybits and Google Sheets

Quick overview

This workflow watches a Gmail label for reference-check emails, extracts structured fields from attached reference letters using easybits Extractor, calculates a sentiment score, and appends one comparable row per letter to a Google Sheets “References” tab, then relabels the processed email.

How it works

  1. Triggers every minute when a new email appears under the selected Gmail label and downloads its attachments.
  2. Splits the email into one item per attachment and keeps only real document files (PDF/JPG/PNG/TIFF), excluding likely logos and signatures by filename.
  3. Processes each remaining attachment one at a time and sends it to easybits Extractor to pull structured reference fields (for example candidate name, strengths, weaknesses, and would-rehire).
  4. Normalizes the extracted fields into consistent formats and enums, then computes a deterministic 0–100 sentiment score and high/mid/low tier.
  5. Appends a new row with the normalized fields, score, and timestamp to a Google Sheets spreadsheet.
  6. Removes the source email from the trigger label and adds a “processed” label in Gmail to prevent double-processing.

Setup

  1. Connect Gmail OAuth2 credentials and set up two Gmail labels (one to trigger on for incoming references and one to mark processed), then configure the trigger and label actions to use those label IDs.
  2. Install and connect the easybits Extractor community node (if self-hosted) and add your easybits Extractor API credentials.
  3. Connect Google Sheets OAuth2 credentials and select the target spreadsheet and the “References” sheet/tab with columns matching the fields the workflow writes (candidate name, referee details, strengths/weaknesses text, tone, would rehire, sentiment score/tier, notable quote, received at).

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - Gmail Trigger

Type / Role
n8n-nodes-base.gmailTrigger - gmailTrigger
Config choices
Version 1.3

Block 2 - Split Out: Attachments

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 3 - Filter: Real Documents

Type / Role
n8n-nodes-base.filter - filter
Config choices
Version 2.3

Block 4 - Loop Over Letters

Type / Role
n8n-nodes-base.splitInBatches - splitInBatches
Config choices
Version 3

Block 5 - Extract Reference: Letter

Type / Role
@easybits/n8n-nodes-extractor.easybitsExtractor - easybitsExtractor
Config choices
Version 2

Block 6 - Normalize Reference: Fields

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 7 - Score Reference: Sentiment

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 8 - Append Row: References

Type / Role
n8n-nodes-base.googleSheets - googleSheets
Config choices
Version 4.7

Block 9 - Remove Label: References

Type / Role
n8n-nodes-base.gmail - gmail
Config choices
Version 2.2

Block 10 - Add Label: Processed

Type / Role
n8n-nodes-base.gmail - gmail
Config choices
Version 2.2

Block 11 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 12 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 13 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 14 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 15 - Sticky Note4

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 16 - Sticky Note5

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 17 - Sticky Note6

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 18 - Sticky Note7

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 19 - Sticky Note8

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 20 - Sticky Note9

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 21 - Sticky Note10

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

3. Summary Table

Workflow Parse reference letters from Gmail with easybits and Google Sheets
Complexity advanced
Nodes 21
Categories HR, AI Summarization
Author Felix
Published 03 Jun 2026

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/16099/16099.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Parse reference letters from Gmail with easybits and Google Sheets do?

Quick overview This workflow watches a Gmail label for reference check emails, extracts structured fields from attached reference letters using easybits Extractor, calculates a sentiment score, and...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your HR, AI Summarization use case.