Skip to main content

browse_movies

Browse the movie collection with filters for genre, decade, director, and year.
decade
string
Optional: filter by decade (e.g. ‘1990’, ‘2000’)
director
string
Optional: filter by director name
genre
string
Optional: filter by genre (e.g. ‘Horror’, ‘Comedy’, ‘Drama’)
include_images
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
limit
number
Number of movies to return Defaults to 10.
order
string
Optional: sort order (default: desc) One of: asc, desc.
page
number
Page number Defaults to 1.
sort
string
Optional: sort by field (default: watched_at). Options: watched_at, title, year, rating
year
string
Optional: filter by release year

get_movie_details

Get detailed information about a specific movie by ID, including director, genres, rating, summary, watch history, poster image, and Letterboxd review links for rated watches.
id
number
required
Movie ID
include_images
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.

get_recent_watches

Get recently watched movies and TV shows from Plex and Letterboxd.
date
string
Optional: filter to a specific date (YYYY-MM-DD)
from
string
Optional: start of date range (ISO 8601)
include_images
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
limit
number
Number of recent watches to return (max 50) Defaults to 10.
page
number
Page number for pagination (1-indexed). Combine with limit to page through longer windows like “last month”. Defaults to 1.
to
string
Optional: end of date range (ISO 8601)

get_watching_decades

Get decade breakdown across all watched movies. This tool takes no parameters.

get_watching_directors

Get top directors by watched-movie count.
limit
number
Number of directors to return Defaults to 20.

get_watching_genres

Get genre breakdown across all watched movies. This tool takes no parameters.

get_watching_stats

Get overall watching statistics including total movies, watch time, movies this year, top genre, top director, TV show counts, and episode counts.
date
string
Optional: filter to a specific date (YYYY-MM-DD)
from
string
Optional: start of date range (ISO 8601)
to
string
Optional: end of date range (ISO 8601)