Tmdb MCP Server

by cyanheadsio.github.cyanheads/tmdb-mcp-serverv0.1.4

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

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Tmdb MCP server

claude mcp add tmdb-cyanheads -e TMDB_API_KEY='<tmdb-api-key>' -- npx -y @cyanheads/tmdb-mcp-server

{
  "mcpServers": {
    "tmdb-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/tmdb-mcp-server"
      ],
      "env": {
        "TMDB_API_KEY": "<tmdb-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "tmdb-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/tmdb-mcp-server"
      ],
      "env": {
        "TMDB_API_KEY": "<tmdb-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "tmdb-cyanheads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/tmdb-mcp-server"
      ],
      "env": {
        "TMDB_API_KEY": "<tmdb-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "tmdb-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/tmdb-mcp-server"
      ],
      "env": {
        "TMDB_API_KEY": "<tmdb-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TMDB_API_KEY	yes	yes	TMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.
TMDB_LANGUAGE	—	—	Default response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.
TMDB_DEFAULT_REGION	—	—	Default ISO 3166-1 country hint (e.g. 'US') used in region-aware error messages.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_TRANSPORT_TYPE	—	—	Selects the HTTP transport.

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-10-07 · 3d ago · GitHub · v0.1.4
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 3d ago · official registry · v0.1.4

FAQ

›How do I install the Tmdb MCP server in Claude Code?

Run: claude mcp add tmdb-cyanheads -e TMDB_API_KEY='<tmdb-api-key>' -- npx -y @cyanheads/tmdb-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Tmdb require an API key?

Yes. It expects TMDB_API_KEY, of which 1 is a secret.

›Can I use Tmdb as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Tmdb in the official MCP registry?

Yes, as io.github.cyanheads/tmdb-mcp-server.