NestDaddy

Tmdb Mcp Server

io.github.cyanheads/tmdb-mcp-server · v0.2.0

Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).

Connect Runs on your machine

Terminal
claude mcp add tmdb-mcp-server -e TMDB_API_KEY=<TMDB_API_KEY> -e TMDB_LANGUAGE=<TMDB_LANGUAGE> -e TMDB_DEFAULT_REGION=<TMDB_DEFAULT_REGION> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "tmdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
        "TMDB_DEFAULT_REGION": "<TMDB_DEFAULT_REGION>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "tmdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
        "TMDB_DEFAULT_REGION": "<TMDB_DEFAULT_REGION>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "tmdb-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
        "TMDB_DEFAULT_REGION": "<TMDB_DEFAULT_REGION>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
TMDB_API_KEY
Required, secret
TMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.
TMDB_LANGUAGE
Optional
Default response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.
TMDB_DEFAULT_REGION
Optional
ISO 3166-1 country example in discovery missing-watch_region errors; never a query default.
MCP_LOG_LEVEL
Optional
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Details

Package@cyanheads/[email protected] (NPM, stdio)
Package@cyanheads/[email protected] (NPM, streamable-http)
First published30 Oct 2026
Last updated30 Oct 2026
Registry nameio.github.cyanheads/tmdb-mcp-server

More search and web servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.