# tmdb-mcp-server

This server gives an AI agent access to TMDB search, film and TV details, recommendations, and trends. Use it to explore titles or people without leaving a chat.

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

## What it does

The server exposes tools for searching movies and TV shows, retrieving their details, and finding cast and crew credits. Movie discovery can filter by genre, language, year range, rating, and sort order; TV discovery offers its own filters. Agents can also look up entertainment professionals, get biographical details, and check daily or weekly trends.

A TMDB access token is required and must be supplied as `TMDB_ACCESS_TOKEN`. In Claude Code, the server starts through `npx` and communicates over stdio. Without the token, requests to TMDB cannot work. An HTTP transport is also available for remote deployment.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TMDB_ACCESS_TOKEN` — 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 tmdb-mcp-server -e TMDB_ACCESS_TOKEN=<TMDB_ACCESS_TOKEN> -- npx -y tmdb-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tcehjaava-tmdb-mcp-server --env TMDB_ACCESS_TOKEN=<TMDB_ACCESS_TOKEN> -- npx -y tmdb-mcp-server
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TMDB_ACCESS_TOKEN=<TMDB_ACCESS_TOKEN> tcehjaava-tmdb-mcp-server npx -y tmdb-mcp-server
```
Replace <…> with your own values

## When to use it
- search for films using a title or filters
- retrieve a movie’s budget, runtime, and credits
- get suggestions based on a specific film
- look up TV series seasons and episodes
- check trending movies, shows, or people

## Example prompts
- Find movies matching this genre and release year.
- Show the cast and budget for The Matrix.
- Which TV shows are trending now?

## 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
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

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