Koskamo

TMDB MCP Server

An MCP server for The Movie Database (TMDB) that allows agents to search and look up movies, TV shows, and people. It retrieves metadata such as overviews, genres, runtime, cast, and directors. With an optional OMDb key, it also fetches IMDb, Rotten Tomatoes, and Metacritic ratings. It speaks standard MCP over stdio, compatible with clients like Claude Desktop, Cursor, and VS Code.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

TMDB MCP Server logo, by GrinvCommunity listingLocal stdioSource reviewed; not executedPublished by Grinv
You need:Once it's connected, just ask your agent in natural language (needs a free TMDB token; see Getting your credentials )The only required credential is a TMDB v4 Read Access Token
Vendor documentation

What you can do with it

  • Search for movies and TV shows by title or keyword
  • Retrieve detailed metadata like genres, runtime, and cast
  • Find trending movies or highly-rated films by genre
  • Get IMDb, Rotten Tomatoes, and Metacritic ratings via OMDb

Source and maintenance

Community listingRegistry 0.14.0
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

tmdb-mcp 0.14.0

npmnpx
tmdb-mcp package definition
{
  "version": "0.14.0",
  "transport": "stdio",
  "identifier": "tmdb-mcp",
  "runtimeHint": "npx",
  "registryType": "npm",
  "environmentVariables": [
    {
      "name": "TMDB_API_TOKEN",
      "isRequired": true,
      "description": "Required. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token)."
    },
    {
      "name": "OMDB_API_KEY",
      "description": "Optional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings."
    },
    {
      "name": "TMDB_LANGUAGE",
      "default": "en-US",
      "description": "Optional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja)."
    },
    {
      "name": "TMDB_REGION",
      "default": "US",
      "description": "Optional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "tmdb-mcp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp@0.14.0"
      ],
      "env": {
        "TMDB_API_TOKEN": "<YOUR_TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<YOUR_OMDB_API_KEY>",
        "TMDB_LANGUAGE": "<YOUR_TMDB_LANGUAGE>",
        "TMDB_REGION": "<YOUR_TMDB_REGION>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "tmdb-mcp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp@0.14.0"
      ],
      "env": {
        "TMDB_API_TOKEN": "<YOUR_TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<YOUR_OMDB_API_KEY>",
        "TMDB_LANGUAGE": "<YOUR_TMDB_LANGUAGE>",
        "TMDB_REGION": "<YOUR_TMDB_REGION>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "tmdb-mcp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp@0.14.0"
      ],
      "env": {
        "TMDB_API_TOKEN": "<YOUR_TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<YOUR_OMDB_API_KEY>",
        "TMDB_LANGUAGE": "<YOUR_TMDB_LANGUAGE>",
        "TMDB_REGION": "<YOUR_TMDB_REGION>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "tmdb-mcp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tmdb-mcp@0.14.0"
      ],
      "env": {
        "TMDB_API_TOKEN": "<YOUR_TMDB_API_TOKEN>",
        "OMDB_API_KEY": "<YOUR_OMDB_API_KEY>",
        "TMDB_LANGUAGE": "<YOUR_TMDB_LANGUAGE>",
        "TMDB_REGION": "<YOUR_TMDB_REGION>"
      }
    }
  }
}

Let your agent find its tools

Find servers like TMDB MCP Server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.