Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Letterboxd with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Letterboxd API v0 as an MCP: film search, full film details with rating histograms, member profiles and diaries. official HMAC-SHA256 signed API (access grante

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 6 capabilities

The complete Letterboxd capability set.

These are the exact actions your AI can choose when you ask it to work with Letterboxd.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 6 available through Letterboxd.

  1. 01

    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

  2. 02

    Get film details

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

  3. 03

    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)

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through Letterboxd.

  1. 04

    Search members

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

  2. 05

    Get member profile

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

  3. 06

    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

One connector, every AI

Letterboxd works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Letterboxd to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Letterboxd, so you can see the experience inside your AI.

It does not authenticate your account with Letterboxd. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Letterboxd Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_qA1kN4kUSQ9o6ZmpsSsRrM27qNucAQ2GUSPcwOO0/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Letterboxd capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "letterboxd-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_qA1kN4kUSQ9o6ZmpsSsRrM27qNucAQ2GUSPcwOO0/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? link.label

See all the AI clients this connector works with ↑

FAQ

Questions Letterboxd owners ask.

  • 01

    How do I get an API key?

    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.

  • 02

    How does the request signing work?

    Every request adds apikey, nonce (unique UUID) and timestamp (unix seconds) params. The signature is the lower-case hex HMAC-SHA256 of the salted bytestring METHOD \0 fully-qualified URL \0 JSON body, using your API secret. appended as the final signature query parameter. Form-encoded POSTs (like /auth/token) put the signature in the Authorization header instead.

Explore

More in Data Analytics

Suggestions