MCP.Market

Tmdb MCP server

by tcehjaava·io.github.tcehjaava/tmdb-mcp-server·v0.1.1·5 stars
No reviews yet

MCP server for The Movie Database (TMDB) API

C66/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C66/100

full report

Adoption
New

5 stars78 downloads/wk

Reviews

Write one

Nobody has reviewed Tmdb yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Tmdb tools (13)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • discover_movies

    Discover movies with advanced filters including genre, language, year range, rating, and sorting. Perfect for finding movies that match specific criteria like 'Japanese sci-fi movies from 2020 onwards with rating above 7' or 'Korean dramas with high ratings'.

  • discover_tv_shows

    Discover TV shows with advanced filters including genre, language, year, rating, and sorting. Perfect for finding shows that match specific criteria like 'Korean dramas from 2023 with rating above 7' or 'Japanese anime shows'.

  • get_movie_credits

    Get cast and crew information for a specific movie. Returns actors with their characters and crew members with their roles/departments.

  • get_movie_details

    Get detailed information about a specific movie using its TMDB ID. Returns comprehensive details including budget, revenue, runtime, genres, production companies, and more.

  • get_person_details

    Get detailed biographical information about a person (actor, director, crew member). Returns full biography, birth info, death date (if applicable), IMDb ID, homepage, and more.

  • get_recommendations

    Get movie recommendations based on a specific movie. Returns similar movies that users who liked the given movie also enjoyed. Great for 'If you liked X, try Y' suggestions.

  • get_trending

    Get daily or weekly trending movies, TV shows, or people. Returns what's currently popular on TMDB based on user activity.

  • get_tv_credits

    Get cast and crew information for a specific TV show. Returns actors with their characters and crew members with their roles/departments.

  • get_tv_details

    Get detailed information about a specific TV show using its TMDB ID. Returns comprehensive details including number of seasons, episodes, networks, creators, and more.

  • get_tv_recommendations

    Get TV show recommendations based on a specific show. Returns similar shows that users who liked the given show also enjoyed.

  • search_movies

    Search for movies by title. Returns a list of movies matching the search query with basic information like title, release date, overview, and rating.

  • search_people

    Search for people (actors, directors, producers, crew) by name. Returns basic info including profile photo, known for department, and movies/TV shows they're known for.

  • search_tv_shows

    Search for TV shows by name. Returns a list of TV shows matching the search query with basic information like name, first air date, overview, and rating.

Public scan report

scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 359 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 66/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Tmdb compares

Against every graded Databases MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
66/100
higher than 18% of 802 Databases servers
Tools
13
the typical Databases server has 8
Tools that change things
0%
typical: 10%. Fewer write tools means less an agent can break
GitHub stars
5
more than 73% of 602 Databases servers
Downloads a week
78
more than 50% of 328 Databases servers with a package

What its tools let an agent do: 13 read

Install Tmdb in Claude Code, Cursor or VS Code

Runs npx -y tmdb-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add tmdb-mcp-server -- npx -y tmdb-mcp-server
Add to Cursor

What the publisher says

From the Tmdb repository's README, as published. We do not edit it. Read it on GitHub

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

  • searchmovies** - Search for movies by title
  • getmoviedetails - Get detailed information about a specific movie (budget, revenue, runtime, genres, etc.)
  • discovermovies** - Discover movies with advanced filters (genre, language, year range, rating, sorting)
  • getrecommendations** - Get movie recommendations based on a specific movie
  • getmoviecredits - Get cast and crew information for a movie

📺 TV Show Tools

  • searchtvshows - Search for TV shows by name
  • gettvdetails - Get detailed information about a specific TV show (seasons, episodes, networks, etc.)
  • discovertvshows - Discover TV shows with advanced filters (genre, language, year, rating, sorting)
  • gettvrecommendations - Get TV show recommendations based on a specific show
  • gettvcredits - Get cast and crew information for a TV show

👥 People Tools

  • searchpeople** - Search for actors, directors, and other entertainment industry professionals
  • getpersondetails - Get detailed biographical information about a person

🔥 Trending

  • gettrending** - 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
  1. Install dependencies:
npm install
  1. Create a .env file with your TMDB access token:
cp .env.example .env
# Edit .env and add your TMDB_ACCESS_TOKEN
  1. Build the server:
npm run build

Usage

With Claude Desktop

Add the server to your Claude Desktop configuration:

MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json Windows: %APPDATA%/Claude/claudedesktopconfig.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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Tmdb: common questions

Is Tmdb MCP server safe?
With care: it is graded C, so read the findings first (66/100). Read the Tmdb safety report
How do I install Tmdb?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Tmdb need an API key?
Yes. The registry entry asks for TMDB_ACCESS_TOKEN.
Is Tmdb maintained?
The last commit was 392 days ago (2025-10-08). The latest release is v0.1.1.
What can I use instead of Tmdb?
Servers from other publishers that do the same job: ČSFD MCP server, CogniCore MCP server and DBHub MCP server.
How does Tmdb compare with other Databases MCP servers?
safety score 66/100 (higher than 18% of 802 Databases servers); tools 13 (the typical Databases server has 8); tools that change things 0% (typical: 10%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Tmdb

Same job from other publishers: the closest match first, then the best rated.

  • ČSFD
    Movies, TV series, creators and user ratings from ČSFD.cz, the Czech-Slovak film database
    A
  • CogniCore
    Memory, reflection and safety for AI agents. Hosted or local, no vector database.
    A
  • DBHub
    Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite
    A
  • Neo4j Cypher
    A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.
    More from neo4j-contrib →
    A
  • Appwrite
    Build and deploy backends: auth, Postgres/MySQL/vector databases, storage, functions, hosting, CDN
    A