Skip to main content

​
Overview

The Watching domain tracks movies and TV shows from two sources:
  • Plex: real-time watch events via webhooks, plus a daily library scan.
  • Letterboxd: ratings, reviews, and watch history from the RSS feed, synced a few times a day.
Both sources feed into a unified movie database enriched with TMDB metadata such as posters, ratings, genres, directors, and summaries. Browse every endpoint in the API reference.

​
Filtering

The movies endpoint supports filtering by:
  • genre: filter by genre name.
  • decade: filter by decade (e.g., 2020).
  • director: filter by director name.
  • year: filter by release year.
  • sort: sort field (watched_at, year, title, tmdb_rating).
  • order: asc or desc.

​
Year in review

GET /watching/year/:year returns a year summary including total movies watched, top-rated films, genre breakdown, and decade distribution.

​
Images

Movie posters and backdrops are sourced from TMDB, with fallbacks to Fanart.tv and Plex. See Images for the source and fallback details.

​
From Claude

You can also explore your watching history from Claude. Set up the MCP server, then the watching tools are yours. Ask what you watched last month, or for your top-rated films of a given year.