Letterboxd

Letterboxd MCP Connector for Claude

A+

Letterboxd API v0 as an MCP: film search, full film details with rating histograms, member profiles and diaries — official HMAC-SHA256 signed API (access granted by request).

6 tools Official Updated Oct 1, 2026 Official Vinkius Partner

Letterboxd — the social film diary loved by cinephiles — and its official API v0 as a single MCP server.

What you can do

  • Film search — the full Letterboxd film database by name, with LIDs, years, runtimes and posters
  • Film details — directors, cast, taglines and Letterboxd's famous weighted rating statistics (histogram from 0.5 to 5.0 stars)
  • Member profiles — public profiles with films-watched, lists and fans counts
  • Member diaries — recent logged films with dates, ratings and re-watch flags (member scope)

Authentication (from the official API v0 docs)

  1. Access to the Letterboxd API is granted by request only — email api@letterboxd.com with your project details (subject = app title)
  2. Approved apps receive an API key + API secret
  3. Every request is uniquely signed: add apikey, nonce (unique UUID) and timestamp (unix seconds) params, then append signature = lower-case hex HMAC-SHA256(apiSecret, METHOD + NUL + URL + NUL + JSON body)
  4. Member tools (diary) use POST /auth/token with grant_type=password — the signature goes in the Authorization header for form-encoded POSTs

Who is this for?

Film-data apps, statisticians, watchlist tools and AI agents bringing Letterboxd's social film data into conversations.

letterboxdfilmsmovie-databaseratingssocial-filmcinema

6 tools expose this connector's capabilities to your AI agent.

get_film_statistics

5-5.0 stars), weighted average rating, count of watches, lists and fans. The social analytics layer for films. Get rating statistics for a film: weighted average, histogram, fans, watches, lists

get_film_details

id = LID from search_films. Get full film details by Letterboxd id: cast, crew, ratings statistics, runtimes

search_films

Use film LIDs in get_film_details. Paged via perPage/page; also supports sort options (FilmName, FilmRating, ReleaseDateLatest...). Search films in the Letterboxd database by name (and optionally release year)

search_members

Use memberIds in member film/diary tools. Search Letterboxd members by username (for profile and diary tools)

get_member_profile

memberId from search_members. Get a member profile: name, avatar, bio, stats (films watched, lists)

get_member_diary

Requires member scope granted to your API key. Get a member's diary: recent logged films with dates, ratings and re-watches

See how to talk to your AI agent using Letterboxd.

Search Letterboxd for 'In the Mood for Love' and give me the rating histogram

🎬 **In the Mood for Love (2000) — Wong Kar-wai** Letterboxd weighted rating: **4.3/5** Histogram: massive peak at 4★ and 4.5★, tiny tail below 2★ Fans: 250k+ · Watched: 1.2M+ One of the highest-rated films on the platform. Want the director's other films ranked by Letterboxd rating?

Find member 'boxd' and show their recent diary entries

🎬 **Member diary (Letterboxd)** Recent log entries: - 2026-09-05: Tenet (2020) — ★★★½, rewatch - 2026-09-02: Perfect Days (2023) — ★★★★★ Ratings and re-watch flags pulled from the member's public diary. Want their watchlist too?

Compare Letterboxd ratings for Fight Club and Se7en

🎬 **Fight Club vs Se7en (Fincher double bill)** - Fight Club: 4.3/5 weighted — stronger 4★/4.5★ concentration - Se7en: 4.2/5 weighted — broader 3.5★-4★ spread Fight Club edges it on Letterboxd. Want the full histograms or each film's most-rated year?

Letterboxd API access is granted by request only: email api@letterboxd.com describing your intended use (subject = your app/project title). Approved apps receive an API key + API secret. There is no self-service registration.

Related Connectors