TMDB MCP Server

An MCP server that integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.

Installation

npx -y @adamayoung/mcp-server-tmdb

Usage with Claude Desktop

Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/config.json):

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

Usage with Claude Code

Add the following to your Claude Code settings:

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

Prerequisites

Node.js 18.0.0 or higher
A TMDB API key

Features

Tools

search_movies - Search for movies by title or keywords
get_recommendations - Get movie recommendations based on a movie ID
get_trending - Get trending movies for a specified time window ("day" or "week")

Resources

Movies (tmdb:///movie/<movie_id>) - Comprehensive movie details including title, release date, rating, overview, genres, poster URL, cast, director, and reviews

Development

git clone git@github.com:adamayoung/tmdb-mcp.git
cd tmdb-mcp
npm install
npm run build

To watch for changes:

npm run watch

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

@adamayoung/mcp-server-tmdb

Quick Install