# TMDB MCP Server

Connects your AI agent to The Movie Database and pulls ratings from IMDb or Metacritic. Useful when building media trackers or asking film trivia in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Grinv
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Grinv/tmdb-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/tmdb-mcp-server

## What it does

The server runs over stdio. It provides an interface to query TMDB directly for movies, television shows, cast lists, and trending media. Functions like `get_movies` batch between 1 and 20 titles into compact data cards in a single network roundtrip.

Adding an OMDb key allows the server to enrich TMDB entries with critic ratings. The model receives Rotten Tomatoes, Metacritic, and IMDb scores inside the same response. Discovery utilities help filter titles by date ranges, genre identifiers, studio credits, and country of origin.

Running the server requires a `TMDB_API_TOKEN` v4 read token. Missing tokens will cause errors. The `OMDB_API_KEY`, language code, and regional settings remain optional additions for localized plot overviews and external scores.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TMDB_API_TOKEN`, `OMDB_API_KEY`, `TMDB_LANGUAGE`, `TMDB_REGION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TMDB_API_TOKEN=<TMDB_API_TOKEN> --env OMDB_API_KEY=<OMDB_API_KEY> --env TMDB_LANGUAGE=<TMDB_LANGUAGE> --env TMDB_REGION=<TMDB_REGION> --transport stdio tmdb-mcp-server -- npx -y tmdb-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tmdb-mcp-server --env TMDB_API_TOKEN=<TMDB_API_TOKEN> --env OMDB_API_KEY=<OMDB_API_KEY> --env TMDB_LANGUAGE=<TMDB_LANGUAGE> --env TMDB_REGION=<TMDB_REGION> -- npx -y tmdb-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tmdb-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "tmdb-mcp"
            ],
            "env": {
                "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
                "OMDB_API_KEY": "<OMDB_API_KEY>",
                "TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
                "TMDB_REGION": "<TMDB_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tmdb-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tmdb-mcp"
            ],
            "env": {
                "TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
                "OMDB_API_KEY": "<OMDB_API_KEY>",
                "TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
                "TMDB_REGION": "<TMDB_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TMDB_API_TOKEN=<TMDB_API_TOKEN> -e OMDB_API_KEY=<OMDB_API_KEY> -e TMDB_LANGUAGE=<TMDB_LANGUAGE> -e TMDB_REGION=<TMDB_REGION> tmdb-mcp-server npx -y tmdb-mcp
```
Replace <…> with your own values

## When to use it
- look up actor or director filmographies directly in chat
- pull IMDb, Metacritic, and Rotten Tomatoes scores in a single call
- retrieve similar movies or series based on TMDB viewer trends
- filter releases by genre, release dates, and cast members

## Example prompts
- Show the plot summary, genres, and runtime for Dune: Part Two.
- Compare the Metacritic and Rotten Tomatoes ratings for Barbie and Oppenheimer.
- Find psychological thriller shows similar to Severance.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md