> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Watching

> MCP tools for your Plex and Letterboxd movie and TV history.

## `browse_movies`

Browse the movie collection with filters for genre, decade, director, and year.

<ParamField path="decade" type="string">
  Optional: filter by decade (e.g. '1990', '2000')
</ParamField>

<ParamField path="director" type="string">
  Optional: filter by director name
</ParamField>

<ParamField path="genre" type="string">
  Optional: filter by genre (e.g. 'Horror', 'Comedy', 'Drama')
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

<ParamField path="limit" type="number">
  Number of movies to return Defaults to `10`.
</ParamField>

<ParamField path="order" type="string">
  Optional: sort order (default: desc) One of: `asc`, `desc`.
</ParamField>

<ParamField path="page" type="number">
  Page number Defaults to `1`.
</ParamField>

<ParamField path="sort" type="string">
  Optional: sort by field (default: watched\_at). Options: watched\_at, title, year, rating
</ParamField>

<ParamField path="year" type="string">
  Optional: filter by release year
</ParamField>

## `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.

<ParamField path="id" type="number" required>
  Movie ID
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

## `get_recent_watches`

Get recently watched movies and TV shows from Plex and Letterboxd.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

<ParamField path="limit" type="number">
  Number of recent watches to return (max 50) Defaults to `10`.
</ParamField>

<ParamField path="page" type="number">
  Page number for pagination (1-indexed). Combine with limit to page through longer windows like "last month". Defaults to `1`.
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>

## `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.

<ParamField path="limit" type="number">
  Number of directors to return Defaults to `20`.
</ParamField>

## `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.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>