Skip to content
MCP server

Tmdb MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.2.0
Listing updated
4 days ago

About Tmdb MCP Server

Tmdb MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TMDB_API_KEYTMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.Required
  • TMDB_LANGUAGEDefault response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.
  • TMDB_DEFAULT_REGIONISO 3166-1 country example in discovery missing-watch_region errors; never a query default.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • TMDB_API_KEYTMDB v4 API Read Access Token (JWT). Sent as 'Authorization: Bearer'. Create one at https://www.themoviedb.org/settings/api.Required
  • TMDB_LANGUAGEDefault response language as ISO 639-1, optionally with region (e.g. 'en-US'). Per-call language overrides it.
  • TMDB_DEFAULT_REGIONISO 3166-1 country example in discovery missing-watch_region errors; never a query default.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.

Pricing

Open source

Tmdb MCP Server FAQ

Is Tmdb MCP Server free?

Yes. Tmdb MCP Server is open source, so you can use and self-host it for free.

How do I add Tmdb MCP Server to Claude Code?

Run this command in your terminal: claude mcp add tmdb-mcp-server --env TMDB_API_KEY='<TMDB_API_KEY>' -- npx -y @cyanheads/tmdb-mcp-server