Watching
Movies and TV shows from Plex, Letterboxd, and Trakt, enriched with TMDB metadata.
Overview
The Watching domain tracks movies and TV shows from three 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.
- Trakt: movie and TV episode watch history, so scrobbles from outside Plex still land here.
All sources feed into a unified database enriched with TMDB metadata such as posters, ratings, genres, directors, and summaries. Every watch carries a source (plex, letterboxd, trakt, or manual) so you can tell where it came from. 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 and ask in natural language, like what you watched last month or for your top-rated films of a given year. The get_recent_watches tool renders an interactive poster grid, and Claude answers everything else by querying the database directly with SQL.