Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).
Connect Runs on your machine
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]
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
TMDB_API_KEYRequired, secret | TMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api. |
TMDB_LANGUAGEOptional | Default response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it. |
TMDB_DEFAULT_REGIONOptional | ISO 3166-1 country example in discovery missing-watch_region errors; never a query default. |
MCP_LOG_LEVELOptional | 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 published | 30 Oct 2026 |
| Last updated | 30 Oct 2026 |
| Registry name | io.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.
