TMDB MCP Server logo

TMDB MCP Server

by MCP-Mirror

This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations. It allows users to access comprehensive movie details, trending movies, and personalized recommendations through the Claude Desktop application.

View on GitHub

Last updated: N/A

What is TMDB MCP Server?

The TMDB MCP Server is a Node.js application that acts as an intermediary between the Claude Desktop application and The Movie Database (TMDB) API. It provides tools to search for movies, get recommendations based on movie IDs, and retrieve trending movies, making movie information easily accessible within Claude Desktop.

How to use TMDB MCP Server?

To use the server, you need a TMDB API key and the Claude Desktop application. After cloning the repository and installing dependencies, you build the server and configure Claude Desktop to use it by adding the server's command path and API key to Claude's configuration file. Once configured, you can use natural language commands within Claude to search for movies, get recommendations, and retrieve trending movies.

Key features of TMDB MCP Server

  • Search movies by title or keywords

  • Get movie recommendations based on a movie ID

  • Get trending movies for a specified time window (day or week)

  • Access comprehensive movie details including title, release date, rating, overview, genres, poster URL, cast information, and director

  • Comprehensive error handling for invalid API keys, network errors, and malformed requests

Use cases of TMDB MCP Server

  • Searching for movies based on a specific title or keywords

  • Getting movie recommendations based on a movie you enjoyed

  • Finding out what movies are currently trending

  • Retrieving detailed information about a specific movie

  • Integrating movie information into Claude Desktop workflows

FAQ from TMDB MCP Server

What is the TMDB API key used for?

The TMDB API key is required to authenticate your requests to the TMDB API and allows the server to access movie data.

How do I get a TMDB API key?

You can get a TMDB API key by signing up for a free account on the TMDB website and requesting an API key from your account settings.

Where do I configure the TMDB API key?

The TMDB API key is configured as an environment variable (TMDB_API_KEY) and in the Claude Desktop configuration file.

What versions of Node.js are supported?

The server requires Node.js version 18.0.0 or higher.

How do I contribute to the project?

Contributions are welcome! Please feel free to submit a Pull Request with your changes.