TMDB

Provides access to TMDB data via MCP for movies, TV shows, and people with search, details, discovery, and recommendations.

javascript

2

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tcehjaava-tmdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp-server"
      ],
      "env": {
        "TMDB_ACCESS_TOKEN": "YOUR_TMDB_ACCESS_TOKEN"
      }
    }
  }
}

You can access The Movie Database (TMDB) data through an MCP server that exposes movie, TV show, and person information to MCP clients like Claude. This server lets you search, fetch details, discover content, and get personalized recommendations from TMDB via simple MCP requests.

How to use

You run the TMDB MCP Server as an MCP endpoint and connect your MCP clients to it. Start it in stdio mode to keep everything local, or run it remotely in HTTP mode if you prefer a network-based setup. You’ll need a TMDB API token to authorize requests. Once running, you can search for movies, TV shows, and people, fetch detailed information, discover content with filters, and request recommendations.

How to install

Prerequisites: you need Node.js version 18 or higher and a TMDB API access token.

Option A: Install from npm (recommended) — this adds a ready-to-run MCP server globally.

Run these commands exactly as shown:

npm install -g tmdb-mcp-server

From source (for development)

If you prefer to work from source, follow these steps to clone the project, install dependencies, and run the server locally.

Commands:

git clone https://github.com/tcehjaava/tmdb-mcp-server.git
cd tmdb-mcp-server
npm install
cp .env.example .env
# Edit .env and add your TMDB_ACCESS_TOKEN
npm run build

Run the server after install

Use the stdio transport to run the server locally and expose your MCP commands to clients. Provide your TMDB access token in the environment.

"command": "npx",
"args": ["-y", "tmdb-mcp-server"],
"env": {
  "TMDB_ACCESS_TOKEN": "your_tmdb_access_token_here"
}

Available tools

search_movies

Search for movies by title.

get_movie_details

Fetch detailed information about a specific movie (budget, revenue, runtime, genres, etc.).

discover_movies

Discover movies using filters like genre, language, year range, rating, and sorting.

get_recommendations

Get movie recommendations based on a specific movie.

get_movie_credits

Retrieve cast and crew information for a movie.

search_tv_shows

Search for TV shows by name.

get_tv_details

Fetch detailed information about a specific TV show (seasons, episodes, networks, etc.).

discover_tv_shows

Discover TV shows using filters like genre, language, year, and rating.

get_tv_recommendations

Get TV show recommendations based on a specific show.

get_tv_credits

Fetch cast and crew information for a TV show.

search_people

Search for actors, directors, and other entertainment professionals.

get_person_details

Fetch detailed biographical information about a person.

get_trending

Get daily or weekly trending movies, TV shows, or people.