# TMDB MCP Server

> TMDB MCP Server is an open-source MCP server for events and entertainment. Movie and TV lookup via TMDB, with IMDb, Rotten Tomatoes and Metacritic ratings. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/grinv/tmdb-mcp
- **MCP Registry name:** io.github.Grinv/tmdb-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment), [tv and radio guides](https://ai-powered.com/categories/tv-and-radio-guides)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Sf Recpark](https://ai-powered.com/mcp/sf-recpark): Sf Recpark is a freemium MCP server for events and entertainment.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Skiddle](https://ai-powered.com/mcp/skiddle): Skiddle is a freemium MCP server for events and entertainment.
- [Nyc Parks](https://ai-powered.com/mcp/nyc-parks): Nyc Parks is a freemium MCP server for events and entertainment.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source MCP server for events and entertainment.
- [Luma](https://ai-powered.com/mcp/luma): Luma is a freemium MCP server for events and entertainment.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/tmdb-mcp-server
