TMDB Movie Database MCP Server

EntertainmentTypeScript

Access movie information, search, and recommendations from The Movie Database (TMDB)

Available Tools

search_movies

Search for movies by title or keywords

query

get_recommendations

Get movie recommendations based on a movie ID

movieId

get_trending

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

timeWindow

The TMDB Movie Database MCP provides seamless integration with The Movie Database API, allowing you to search for movies, get trending titles, and receive personalized recommendations. With comprehensive movie details including cast information, ratings, and reviews, this MCP enhances Claude's ability to provide up-to-date film information. This server makes it easy to discover new movies based on your interests, stay informed about trending titles, and access detailed information about specific films. All data is sourced directly from TMDB's extensive database, ensuring accurate and current movie information.

Overview

The TMDB Movie Database MCP server connects Claude to The Movie Database (TMDB) API, providing access to movie information, search capabilities, and personalized recommendations.

Prerequisites

Before installing the TMDB MCP server, you'll need:

A TMDB account and API key (free from themoviedb.org)
Node.js (version 18.0.0 or higher)
npm (version 8.0.0 or higher)

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install the TMDB MCP server is through Smithery:

npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude

This will automatically configure the server for use with Claude Desktop.

Option 2: Manual Installation

Clone the repository:

git clone https://github.com/Laksh-star/mcp-server-tmdb.git
cd mcp-server-tmdb

Install dependencies:
```
npm install
```
Build the server:
```
npm run build
```
Configure Claude Desktop by editing your configuration file (located at ~/Library/Application Support/Claude/config.json):
```
{
  "mcpServers": {
    "tmdb": {
      "command": "/full/path/to/dist/index.js",
      "env": {
        "TMDB_API_KEY": "your_api_key_here"
      }
    }
  }
}
```
Replace /full/path/to with the actual path to your project directory and your_api_key_here with your TMDB API key.

Usage Examples

Once the server is running with Claude Desktop, you can use natural language to interact with the TMDB database:

Search for movies:

"Find movies about artificial intelligence"
"Search for films directed by Christopher Nolan"

Get trending movies:

"What are the trending movies today?"
"Show me this week's most popular films"

Get movie recommendations:

"Recommend movies similar to The Matrix"
"What should I watch if I liked Inception?"

Get movie details:

"Tell me about Interstellar"
"What's the plot of The Shawshank Redemption?"

Troubleshooting

If you encounter issues:

Verify your TMDB API key is correct and has been approved for use
Check that the environment variable is properly set
Ensure Node.js and npm are updated to the required versions
Restart Claude Desktop after making configuration changes

Limitations

The server returns a maximum of 10 results for searches and trending movies
Movie recommendations are based on TMDB's algorithm and may not always match personal preferences
Some detailed information may be limited for less popular or older movies