Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
npm install
npm start2
Register it in Claude Code
claude mcp add -e "LETTERBOXD_USERNAME=${LETTERBOXD_USERNAME}" -e "LETTERBOXD_PASSWORD=${LETTERBOXD_PASSWORD}" letterboxd-mcp -- node /path/to/letterboxd-mcp/index.jsReplace any placeholder paths in the command with the real path on your machine.
Required:
LETTERBOXD_USERNAMELETTERBOXD_PASSWORD+ 1 optional3
Make your agent remember this setup
letterboxd-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- 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.
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 usernameLETTERBOXD_PASSWORDrequiredYour Letterboxd account passwordPORTPort for the SSE serverTry 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.
Original README from Racimy/Letterboxd-MCP
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é
mepour 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é.