TMDB MCP Server

A Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables Claude and other MCP clients to search for movies, TV shows, and people, as well as get detailed information and recommendations.

🌟 Now available on the Official MCP Registry

Quick Start

Get started in seconds with npm:

# Install globally
npm install -g tmdb-mcp-server

# Or use with npx (no installation needed)
npx tmdb-mcp-server

Get your free TMDB API token: https://www.themoviedb.org/settings/api

Features

🎬 Movie Tools

• search_movies - Search for movies by title
• get_movie_details - Get detailed information about a specific movie (budget, revenue, runtime, genres, etc.)
• discover_movies - Discover movies with advanced filters (genre, language, year range, rating, sorting)
• get_recommendations - Get movie recommendations based on a specific movie
• get_movie_credits - Get cast and crew information for a movie

📺 TV Show Tools

• search_tv_shows - Search for TV shows by name
• get_tv_details - Get detailed information about a specific TV show (seasons, episodes, networks, etc.)
• discover_tv_shows - Discover TV shows with advanced filters (genre, language, year, rating, sorting)
• get_tv_recommendations - Get TV show recommendations based on a specific show
• get_tv_credits - Get cast and crew information for a TV show

👥 People Tools

• search_people - Search for actors, directors, and other entertainment industry professionals
• get_person_details - Get detailed biographical information about a person

🔥 Trending

• get_trending - Get daily or weekly trending movies, TV shows, or people

Installation

Option 1: npm (Recommended)

Install from npm registry:

npm install -g tmdb-mcp-server

That's it! No build step required.

Option 2: From Source (For Development)

Prerequisites:

• Node.js (v18 or higher)
• A TMDB API access token (get one free at TMDB)

Steps:

1. Clone the repository:

git clone https://github.com/tcehjaava/tmdb-mcp-server.git
cd tmdb-mcp-server

2. Install dependencies:

npm install

3. Create a .env file with your TMDB access token:

cp .env.example .env
# Edit .env and add your TMDB_ACCESS_TOKEN

4. Build the server:

npm run build

Usage

With Claude Desktop

Add the server to your Claude Desktop configuration:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

If installed via npm:

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

If installed from source:

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["/absolute/path/to/tmdb-mcp-server/build/index.js"],
      "env": {
        "TMDB_ACCESS_TOKEN": "your_tmdb_access_token_here"
      }
    }
  }
}

With Other MCP Clients

The server runs on stdio by default, making it compatible with any MCP client that supports stdio transport.

Remote Deployment (HTTP Mode)

The server also supports Streamable HTTP transport for remote deployment:

MCP_TRANSPORT=http PORT=3000 node build/index.js

See TRANSPORT.md for detailed deployment inst

... View full README on GitHub