Letterboxd MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install
npm start
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "LETTERBOXD_USERNAME=${LETTERBOXD_USERNAME}" -e "LETTERBOXD_PASSWORD=${LETTERBOXD_PASSWORD}" letterboxd-mcp -- node "<FULL_PATH_TO_LETTERBOXD_MCP>/dist/index.js"

Replace <FULL_PATH_TO_LETTERBOXD_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:LETTERBOXD_USERNAMELETTERBOXD_PASSWORD+ 1 optional
README.md

A comprehensive MCP server for Letterboxd using Playwright and Axios.

Letterboxd MCP Server (V3)

Un serveur MCP ultra-complet pour Letterboxd utilisant Playwright pour les actions réelles et Axios pour le scraping rapide.

Fonctionnalités Clés

  • Données Riches : Posters HD, Casting complet, Durée, Genres et Synopsis intégral pour chaque film.
  • Accès Privé : Supporte l'accès à votre Watchlist, Journal et Listes privées via authentification sécurisée.
  • Actions Réelles (Browser) : Notez des films, ajoutez des cœurs, gérez votre watchlist et créez des listes exactement comme un humain.
  • Pagination Infinie : Fouille absolument toutes les pages pour chaque requête par défaut.
  • Localisation Automatique : Support du mot-clé me pour cibler votre propre compte sans configuration complexe.

Configuration

Créez un fichier .env :

LETTERBOXD_USERNAME=votre_pseudo
LETTERBOXD_PASSWORD=votre_mdp
PORT=3000

Installation

npm install
npm start

Le script postinstall téléchargera automatiquement le navigateur Chromium nécessaire pour les actions.

Lancer en mode stdio (optionnel)

node index.js --mode=stdio

Par défaut le serveur utilise SSE via Express ; le mode stdio reste disponible pour les clients MCP qui le nécessitent.

Tools Disponibles

Lecture

  • search: Recherche globale (films, membres, listes).
  • get_film: Détails profonds d'un film (slug requis).
  • get_member_watchlist: Votre liste à voir (privee supportée).
  • get_member_diary: Votre journal de visionnage.
  • get_member_films: Tous les films que l'utilisateur a vus (toutes les pages), avec les éventuelles notes étoilées.
  • get_member_pinned: Vos 4 films préférés (épinglés).
  • get_member_lists: Toutes vos listes (inclus privées).

Écriture (Playwright)

  • add_to_watched: Marquer comme vu / retirer.
  • add_to_watchlist: Ajouter / retirer de la watchlist.
  • rate_film: Donner une note (1 à 10).
  • toggle_like: Ajouter / retirer un cœur.
  • write_review: Publier une critique dans votre journal.
  • add_to_list: Ajouter un film à une liste existante.
  • create_list: Créer une nouvelle liste (min. 1 film requis).

Astuce

Utilisez username: "me" dans n'importe quel outil pour cibler automatiquement votre compte connecté.

Tools (14)

searchGlobal search for films, members, and lists.
get_filmGet deep details of a film using its slug.
get_member_watchlistRetrieve the user's watchlist.
get_member_diaryRetrieve the user's viewing diary.
get_member_filmsRetrieve all films seen by a user.
get_member_pinnedRetrieve the user's 4 pinned favorite films.
get_member_listsRetrieve all lists created by a user.
add_to_watchedMark a film as watched or remove it.
add_to_watchlistAdd or remove a film from the watchlist.
rate_filmRate a film from 1 to 10.
toggle_likeAdd or remove a heart/like from a film.
write_reviewPublish a review to the user's diary.
add_to_listAdd a film to an existing list.
create_listCreate a new list with at least one film.

Environment Variables

LETTERBOXD_USERNAMErequiredYour Letterboxd account username
LETTERBOXD_PASSWORDrequiredYour Letterboxd account password
PORTPort for the SSE server

Configuration

claude_desktop_config.json
{"mcpServers": {"letterboxd": {"command": "node", "args": ["/path/to/letterboxd-mcp/index.js"], "env": {"LETTERBOXD_USERNAME": "your_username", "LETTERBOXD_PASSWORD": "your_password"}}}}

Try it

→Search for the film 'Inception' and give me its synopsis and cast.
→Add the movie 'The Matrix' to my watchlist.
→Rate the movie 'Parasite' with 10 stars.
→What are my 4 pinned favorite films?
→Create a new list called 'Sci-Fi Classics' and add 'Blade Runner' to it.

Frequently Asked Questions

What are the key features of Letterboxd MCP Server?

Rich data retrieval including HD posters, full cast, and synopsis.. Private data access for watchlists, diaries, and custom lists.. Automated browser actions for rating, liking, and reviewing films.. Infinite pagination support for all queries.. Automatic 'me' keyword support for targeting the authenticated account..

What can I use Letterboxd MCP Server for?

Automating the organization of movie watchlists based on AI recommendations.. Bulk-logging films to a diary after a movie marathon.. Generating custom movie lists based on specific genres or themes found via search.. Quickly checking film details and ratings without leaving the chat interface..

How do I install Letterboxd MCP Server?

Install Letterboxd MCP Server by running: npm install && npm start

What MCP clients work with Letterboxd MCP Server?

Letterboxd MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Letterboxd MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all browser-automation servers →

Related MCP Servers

Skyvern
Automate Browser-based workflows using LLMs and Computer Vision
browser-automation20.9K stars
Flyto Core
A debuggable automation engine. Trace every step. Replay from any point.
browser-automation278 stars
JS Reverse MCP
Standardizing the frontend JavaScript reverse engineering workflow.
browser-automation227 stars
RednoteMCP
Automated interaction tool for Xiaohongshu (Little Red Book)
browser-automation106 stars
LinkedIn MCP Server
Search people, companies, and jobs, and scrape structured LinkedIn data.
browser-automation95 stars
CortexScout
Deep Research & Web Extraction module for AI agents
browser-automation58 stars