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.

Functions
4
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Letterboxd

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/letterboxd
Every site

One MCP server for Letterboxd and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 4
  • filmReads one film's full record off its letterboxd page.

    Arguments

    NameTypeRequired
    args{ slug: string }Yes

    Returns LetterboxdFilm

    interface 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/film

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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 LetterboxdAccount

    interface LetterboxdAccount {
      username: string;
      role: string;
      profileUrl: string;
      signedIn: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/letterboxd/getOwnAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.letterboxd.getOwnAccount();
  • memberDiaryReads a member's activity feed.

    Arguments

    NameTypeRequired
    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/memberDiary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/memberFilms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.letterboxd.memberFilms({ member: "davidehrlich", limit: 5 });

Use it from code