Letterboxd → Notion

Sync your Letterboxd diary and watchlist into a Notion database. Pages are enriched with poster covers and metadata (director, cast, runtime, genres, IMDb/TMDB links). Runs on Notion Workers, no server or cron required.

Setup

curl -fsSL https://ntn.dev | bash

ntn login

git clone https://github.com/brianlovin/letterboxd-notion-sync.git

cd letterboxd-notion-sync && npm install && npm run setup

Setup asks for a Notion Personal Access Token and your Letterboxd username, creates a 🎬 Films database with three views (Watched / Watchlist / All Films), deploys the worker, and triggers the first sync.

Bring in your history (optional)

The daily sync only sees ~50 recent diary entries. To import everything you've ever logged:

# Export at https://letterboxd.com/settings/data/, unzip, then:
npm run import-csv -- EXPORT_CSV_PATH # replace with the file's location

npm run backfill   # adds posters + metadata

Maintenance

ntn workers sync trigger letterboxdSync   # force a sync now
ntn workers sync status                   # health check
ntn workers runs list                     # recent runs

Edit schedule: "1d" in src/index.ts (valid 5m … 7d) and run ntn workers deploy to change the cadence.

License

MIT — see LICENSE.