Skip to content
MCP server

TMDB MCP Server

Movie and TV lookup via TMDB, with IMDb, Rotten Tomatoes and Metacritic ratings

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.15.0
Listing updated
today

Similar MCP servers

About TMDB MCP Server

TMDB MCP Server is an open-source MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.

This server searches The Movie Database for movies, TV shows and people, and can add IMDb, Rotten Tomatoes and Metacritic scores in the same call using an optional OMDb key. A free TMDB v4 read access token is the only required credential, and language and region can be set for localized results.

Tools cover full details, compact cards for up to 20 ids at a time, cast and crew, recommendations and similar titles, trending lists, theatrical releases, genre references and filmographies. Discover tools filter by genre, dates, rating, cast, companies, keywords, certification and streaming providers, and a watch-provider tool shows where to stream, rent or buy by region. Others return trailers, user reviews, franchise collections and IMDb id lookups.

It runs over stdio through npx, a one-click mcpb bundle or a source build, so it works with clients like Claude Desktop, Cursor and VS Code.

Install

Run in a terminal

claude mcp add tmdb-mcp --env TMDB_API_TOKEN='<TMDB_API_TOKEN>' --env OMDB_API_KEY='<OMDB_API_KEY>' -- npx -y tmdb-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp"
      ],
      "env": {
        "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<OMDB_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp"
      ],
      "env": {
        "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<OMDB_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "tmdb-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp"
      ],
      "env": {
        "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<OMDB_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp"
      ],
      "env": {
        "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<OMDB_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp"
      ],
      "env": {
        "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<OMDB_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TMDB_API_TOKENRequired. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).Required
  • OMDB_API_KEYOptional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.
  • TMDB_LANGUAGEOptional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).
  • TMDB_REGIONOptional. The user's default country, ISO-3166-1 (e.g. US, GB): ratings, cinemas, where to watch.
  • TMDB_API_TOKENRequired. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).Required
  • OMDB_API_KEYOptional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.
  • TMDB_LANGUAGEOptional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).
  • TMDB_REGIONOptional. The user's default country, ISO-3166-1 (e.g. US, GB): ratings, cinemas, where to watch.

Tools this server provides (19)

Taken from the project documentation; the running server may differ.

search_movies
Finds movies by name
search_tv
Finds TV shows by name
search_people
Finds people by name
search_multi
Searches movies, TV and people at once
get_movie
Full movie details with ratings
get_tv
Full TV details with ratings
get_movies
Compact cards for up to 20 movies
get_person
Biography and links for a person
get_movie_credits
Top-billed cast and crew for a movie
get_similar
Algorithmically similar titles
get_trending
Trending movies, TV and people
discover_movies
Filters movies by many criteria
discover_tv
Filters TV shows by many criteria
get_watch_providers
Where to stream, rent or buy
get_person_credits
A person's filmography
get_videos
Trailers and clips
get_reviews
User reviews
get_collection
A franchise and its parts
find_by_imdb_id
Resolves an IMDb id

What it does

Search across media
Movies, TV, people or all at once.
Ratings in one call
IMDb, RT and Metacritic with an OMDb key.
Discovery filters
Genre, dates, cast, providers and certification.
Streaming availability
Where to watch by region.
Batch cards
Compact details for 1 to 20 ids.
Localization
Set language and region defaults.

Good for

  • Find where a show is streaming
  • Compare critics' scores for two films
  • Discover highly rated sci-fi from a decade
  • See a director's filmography and trailers

Pricing

Open source

Open source; needs free TMDB and optional OMDb keys

TMDB MCP Server FAQ

What credential is required?

A free TMDB v4 Read Access Token.

How do I get IMDb and RT scores?

Add an optional free OMDb API key.

Which clients work?

Any stdio MCP client such as Claude Desktop, Cursor or VS Code.

Can I change language?

Yes, with TMDB_LANGUAGE and TMDB_REGION.

Is TMDB MCP Server free?

Yes. TMDB MCP Server is open source, so you can use and self-host it for free.

How do I add TMDB MCP Server to Claude Code?

Run this command in your terminal: claude mcp add tmdb-mcp --env TMDB_API_TOKEN='<TMDB_API_TOKEN>' --env OMDB_API_KEY='<OMDB_API_KEY>' -- npx -y tmdb-mcp

What are the best alternatives to TMDB MCP Server?

The closest alternatives to TMDB MCP Server are Dostuff, Sf Recpark, Edmtrain, Skiddle and Nyc Parks.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers