TMDB MCP Server

Name: TMDB MCP Server
Author: Laksh-star

@Laksh-star

Repository

About TMDB MCP Server

MCP Server with TMDB

Basic information

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>"
      }
    }
  }
}

Tools

No tools detected

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

FAQ from TMDB MCP Server

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.