letterboxd-mcp
Provides tools to retrieve a Letterboxd user's recent diary entries and written reviews, including film title, year, rating, rewatch status, watched date, review text, and TMDB ID, enabling LLMs to understand viewing history and suggest movies.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@letterboxd-mcp Based on my Letterboxd diary, recommend some movies I'd enjoy and explain why."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
letterboxd-mcp
An MCP server that feeds a Letterboxd user's viewing history to LLMs, so the model can read what you watched and suggest new movies you'll actually like.
Why RSS?
Letterboxd has no official public API. The per-user RSS feed (https://letterboxd.com/{username}/rss/) is the only sanctioned machine-readable surface, so this server parses it. No scraping, no login.
Note: the feed only holds the ~50 most recent diary entries.
Related MCP server: Filmladder MCP Server
Tools
Tool | Returns |
| Recent entries: film, year, rating, liked, rewatch, watched date, review text, TMDB id |
| Same, but only entries with written review text |
What it needs
Films must be in your diary for the feed to pick them up. Star-rating a film on its page doesn't count; it never reaches the feed. Use the Log/Review flow instead and set your rating there. Review text optional.
Written reviews still help, even a single line. A rating tells the model what you watched. A review tells it why you liked or hated it, and that second part is what makes its suggestions any good.
Setup
Requires uv.
uv sync
uv run python test_server.py # self-check against bundled fixtures
uv run python smoke.py <your_username> # live end-to-end checkMCP client registration
{
"mcpServers": {
"letterboxd": {
"command": "uv",
"args": ["run", "--directory", "/path/to/letterboxd-mcp", "python", "server.py"]
}
}
}Available Tools
2 toolsget_diaryA
Get a Letterboxd user's recent watched films: title, year, rating, liked, rewatch, watched date, review text, TMDB id. Returns ~50 most recent entries. Use to understand someone's taste before recommending movies.
Inputs: username (required). Returns: result
get_reviewsA
Get only the Letterboxd user's recent diary entries that have written review text (skips plain 'watched on' logs).
Inputs: username (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
get_diary and get_reviews both return diary entries, and get_diary already includes review text. The only distinction is that get_reviews filters out entries without text, which is a minor filtering difference rather than a clearly separate purpose. An agent could easily pick the wrong one or assume get_reviews returns something fundamentally different.
Both tools follow the exact verb_noun pattern (get_ + resource) with clear and consistent naming. get_diary and get_reviews are both prefixed with 'get' and use lowercase snake_case, maintaining a predictable and uniform style.
Two tools is very thin for a Letterboxd server, especially since the broader Letterboxd domain includes films, lists, ratings, watchlists, and user profiles. While the two tools cover a narrow use case, the count feels too low for a comprehensive MCP server.
The tool set covers diary entries and written reviews but lacks any other Letterboxd functionality such as searching films, fetching user profile data, adding to watchlists, or rating films. Even within the 'understanding taste' purpose, there is no way to query older snippets or paginate beyond the ~50 most recent entries, causing incomplete retrospective data.
Related MCP Connectors
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
Find movies and TV shows, track watches, and get suggestions based on your taste.
Your film diary: log and rate films, search what you've watched, keep a watchlist and see stats.
Your film diary: log and rate films, search what you've watched, keep a watchlist and see stats.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants like Claude to interact with The Movie Database (TMDB) API, providing capabilities for searching movies, retrieving movie details, and generating customized movie reviews and recommendations.470 npm4MIT
- FlicenseNot gradedqualityDmaintenanceProvides movie listings, showtimes, and personalized recommendations for Amsterdam cinemas by scraping filmladder.nl, with support for filtering by date, cinema, rating, and preferred showtimes.1-
- FlicenseNot gradedqualityCmaintenanceA comprehensive MCP server that enables users to interact with Letterboxd for searching films, viewing member data, and performing actions like rating or reviewing movies. It supports private data access and automated browser actions for managing watchlists, diaries, and custom lists.1-
- AlicenseNot gradedqualityDmaintenanceEnables AI models to interact with Letterboxd data and perform account actions like rating films, writing reviews, and managing watchlists.4ISC