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.
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
- Fetches unread emails from a Gmail label (default:
Newsletter) on each ingestion run - Stores each email as an article in Postgres, deduplicated by Gmail message ID
- Curates unread articles with Claude — summarizing each one, scoring its relevance, and grouping everything into named themes
- 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:
| Variable | Description |
|---|---|
GMAIL_USER | The Gmail address to read newsletters from |
GMAIL_APP_PASSWORD | An app password (Google Account → Security → App passwords; spaces ignored) |
APP_DATABASE_URL | PostgreSQL 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
| Input | Default | Description |
|---|---|---|
GMAIL_LABEL | Newsletter | Gmail label to pull from |
MAX_EMAILS | 50 | Maximum emails to fetch per run |
DIGEST_FREQUENCY | Weekly | How often to generate a digest (None, Daily or Weekly; None = manual only) |