Letterboxd MCP server for AI agents
Let Claude, ChatGPT or your own agent read Letterboxd: 4 typed functions through one MCP server. No Letterboxd API key needed.
- Site
- letterboxd.com
- Functions
- 4
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Letterboxd alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/letterboxdOne MCP server for Letterboxd and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
filmReads one film's full record off its letterboxd page.Arguments
Name Type Required args{ slug: string }Yes Returns
LetterboxdFilminterface LetterboxdFilm { slug: string; title: string; year: number | null; url: string; directors: string[]; cast: string[]; genres: string[]; countries: string[]; languages: string[]; runtimeMinutes: number | null; description: string | null; posterUrl: string | null; averageRating: number | null; ratingCount: number | null; reviewCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/letterboxd/filmCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.letterboxd.film({ slug: "parasite-2019" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.letterboxd.film({"slug": "parasite-2019"}))curl -X POST https://api.bowmark.ai/v1/sites/letterboxd/film \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"parasite-2019"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.letterboxd.film({ slug: "parasite-2019" });getOwnAccountReads who is signed in on the saved letterboxd login: username, membership role and profile URL, off the viewer block letterboxd server-renders into…Arguments
None.
Returns
LetterboxdAccountinterface LetterboxdAccount { username: string; role: string; profileUrl: string; signedIn: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/letterboxd/getOwnAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.letterboxd.getOwnAccount();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.letterboxd.getOwnAccount())curl -X POST https://api.bowmark.ai/v1/sites/letterboxd/getOwnAccount \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.letterboxd.getOwnAccount();memberDiaryReads a member's activity feed.Arguments
Name Type Required args{ member: string, limit?: number }Yes Returns
LetterboxdDiaryEntry[]interface LetterboxdDiaryEntry { filmTitle: string; filmYear: number | null; slug: string; url: string; rating: number | null; watchedDate: string | null; rewatch: boolean; liked: boolean; publishedAt: string | null; reviewText: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/letterboxd/memberDiaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.letterboxd.memberDiary({ member: "davidehrlich", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.letterboxd.memberDiary({"member": "davidehrlich", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/letterboxd/memberDiary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"member":"davidehrlich","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.letterboxd.memberDiary({ member: "davidehrlich", limit: 5 });memberFilmsLists the films a letterboxd member has logged, newest first, off their own films page.Arguments
Name Type Required args{ member: string, limit?: number }Yes Returns
LetterboxdMemberFilm[]interface LetterboxdMemberFilm { slug: string; title: string; year: number | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/letterboxd/memberFilmsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.letterboxd.memberFilms({ member: "davidehrlich", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.letterboxd.memberFilms({"member": "davidehrlich", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/letterboxd/memberFilms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"member":"davidehrlich","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.letterboxd.memberFilms({ member: "davidehrlich", limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/letterboxd/<function> - OpenAPI
/v1/sites/letterboxd/openapi.json