TMDB MCP Server

@Laksh-star

Basic information

About TMDB MCP Server

MCP Server with TMDB

TMDB MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-tmdb": {
      "command": "node",
      "args": [
        "scripts/tool-surface-smoke.mjs",
        "--mcp-url",
        "https://tmdb-mcp.<your-workers-subdomain>.workers.dev/mcp"
      ],
      "env": {
        "TMDB_MCP_ACCESS_TOKEN": "<your-access-token>"
      }
    }
  }
}

TMDB MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is TMDB MCP Server?

The TMDB MCP Server is an MCP (Model Context Protocol) server that wraps The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast/crew details, and recommendations for AI assistants such as Codex and Claude Desktop.

How to use TMDB MCP Server?

Obtain a TMDB API key from themoviedb.org, clone the repository, install dependencies with npm install, copy .env.example to .env and add your key, then run npm run install:local to register the server with Codex or Claude Desktop. Verify the integration with a prompt like "What movies are trending this week?".

Key features of TMDB MCP Server

Search movies, TV shows, and people by title or keyword
View trending movies and TV shows (daily/weekly)
Filter movies by genre, year, rating, and language
Get detailed movie and person information
Compare 2–5 movies side-by-side
Find streaming, rental, and purchase availability per country
Workflow tools: weekend watchlist, watch party planning, franchise watch order, collection gap plan, and taste‑based recommendations

Use cases of TMDB MCP Server

Plan a movie night with primary, backup, and wildcard picks including provider availability
Build a completion plan for a franchise with watched/missing entries and remaining runtime
Discover which streaming service a specific title is available on in your region
Get personalized recommendations based on liked and disliked titles
Generate a release‑calendar watchlist with provider‑ready picks and watch‑later scoring

Frequently asked questions

What API key do I need?

A TMDB API key from themoviedb.org (Account Settings → API).

How do I run the server locally?

Clone the repo, run `npm install`, copy `.env.example` to `.env` and set `TMDB_API_KEY`, then run `npm run install:local` and restart Codex or Claude Desktop.

Can I run the server remotely?

Yes. Deploy to Cloudflare Workers using `npm run worker:deploy` after storing `TMDB_API_KEY` and optionally `ACCESS_TOKEN` as Worker secrets.

Is authentication required for the remote server?

Authentication is optional. If `ACCESS_TOKEN` is set, requests to `/mcp` and `/api/concierge` require an `Authorization: Bearer <token>` header. If not set, the Worker is authless for personal testing.