Reference Check Parser: turn reference-letter attachments into a comparable candidate sheet

:waving_hand: Hey n8n Community,

A follow-up to my earlier CV summary workflow. The recruiter using that one hit a new bottleneck further down her pipeline: reference letters. They arrive as scanned email attachments, often several forwarded in a single email, and she was reading each one by hand to gauge whether it was positive and what the candidate’s strengths and weaknesses were.

This workflow handles that end to end:

:inbox_tray: A Gmail label triggers on incoming reference emails and downloads attachments

:paperclip: Multi-attachment emails are split so each letter is processed individually, with a filter that drops logos and footer images

:robot: Each letter is read into 10 structured fields: referee, relationship, duration known, strengths, weaknesses, would-rehire signal, and tone

:bar_chart: A deterministic JavaScript step computes a 0–100 sentiment score, kept out of the LLM so it stays consistent across letters, plus a high/mid/low tier

:green_book: One row per reference is appended to a Google Sheet, and the email is relabelled so it won’t be picked up again

Sorted by candidate and score, the sheet turns a pile of prose into something scannable.

Extraction uses the easybits Extractor node. It reads the scans directly and returns clean JSON; the schema fits the free plan at 10 fields.

Workflow JSON with sticky notes and full setup guide:

Open question for the community: I weighted the would-rehire signal most heavily in the score, with tone second. Curious whether others would balance those differently.

Best,
Felix

1 Like

Keeping the sentiment score in a deterministic JS step instead of relying on the LLM is a smart call - it removes a big source of variance when you’re comparing across candidates. On your open question: would-rehire as the heaviest signal makes sense for most hiring contexts, but if the role is very skills-specific, I’d weight the strengths/weaknesses extraction higher. Tone can be misleading since some referees are just blunt writers by default.

1 Like

Hey @nguyenthieutoan, thanks for the kind words! I completely agree with your point. For roles that require a very specific skill set, it makes a lot of sense to give the strengths and weaknesses signals a higher weighting. It would actually be really interesting to build a workflow that focuses on identifying evidence of those key skills within the reference letters, rather than analyzing everything equally. That way, the evaluation could become much more targeted and relevant to the specific role.

1 Like