reading-room

taylorgreen/reading-room 

Reads your Gmail newsletters, uses Claude through the Astro AI Gateway to curate them into themed digests, and serves them as a browsable web page.

Copy a prompt to use in Claude Code, Codex, or Cursor.
Repository
Contributors
Integrations
GmailPostgreSQL
More blueprints
AGENT.md

Reading Room

Reading Room connects to your Gmail, pulls every newsletter you receive, and uses Claude to turn the flood of unread email into a clean, curated digest — grouped by theme, ranked by relevance, and served as a beautiful web page you can actually enjoy reading.

What it does

  1. Fetches unread emails from a Gmail label (default: Newsletter) on each ingestion run
  2. Stores each email as an article in Postgres, deduplicated by Gmail message ID
  3. Curates unread articles with Claude — summarizing each one, scoring its relevance, and grouping everything into named themes
  4. Publishes the digest to a clean editorial web page you can browse any time

What you get

  • A digest page organized into themed sections (e.g. "AI & Research", "Product & Design", "Business & Startups")
  • Per-article summaries and key takeaways extracted by Claude
  • Relevance rankings so the most important articles surface first
  • A private per-issue notebook for jotting your own margin notes, saved across sessions
  • Direct links back to the original content
  • A "Generate digest now" button to trigger curation on demand
  • Multiple reading themes, including a dark-parchment Night mode

Setup

Reading Room connects to Gmail over IMAP with an app password (no OAuth setup, no tokens that expire). You'll need:

VariableDescription
GMAIL_USERThe Gmail address to read newsletters from
GMAIL_APP_PASSWORDAn app password (Google Account → Security → App passwords; spaces ignored)
APP_DATABASE_URLPostgreSQL connection string

This requires 2-Step Verification enabled on the account and IMAP turned on (Gmail → Settings → Forwarding and POP/IMAP).

Create a Gmail label called Newsletter (or configure a custom label name) and apply it to the newsletters you want curated. Reading Room only reads mail with that label — it never touches the rest of your inbox.

Configuration

InputDefaultDescription
GMAIL_LABELNewsletterGmail label to pull from
MAX_EMAILS50Maximum emails to fetch per run
DIGEST_FREQUENCYWeeklyHow often to generate a digest (None, Daily or Weekly; None = manual only)