This server integrates with The Movie Database (TMDB) API to provide movie-related data and functionalities:
Search for movies: Search by title or keywords, returning movies with titles, release years, IDs, ratings, and overviews
Get movie recommendations: Fetch the top 5 recommended movies based on a specific TMDB movie ID
Get trending movies: Retrieve top 10 trending movies for a specified time window (day or week)
Access detailed movie information: Fetch comprehensive movie details including title, release date, rating, overview, genres, poster URL, cast, director, and reviews
Error handling: Includes robust error handling for various scenarios, ensuring a user-friendly experience
Provides access to movie information, search capabilities, and recommendations from The Movie Database (TMDB) API
TMDB MCP Server
This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
Prerequisites
Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:
Required Software
Node.js
Version 18.0.0 or higher
Download from Node.js official website
Verify installation:
node --version
npm (Node Package Manager)
Version 8.0.0 or higher (comes with Node.js)
Verify installation:
npm --version
TypeScript
Will be installed as a project dependency
Can be installed globally:
npm install -g typescript
Verify installation:
tsc --version
Required Accounts & API Keys
TMDB Account
Free account at TMDB
API key from TMDB dashboard
API access must be approved by TMDB
Claude Desktop Application
Latest version installed
Access to modify configuration files
System Requirements
Operating Systems
macOS (10.15 or later)
Linux (modern distributions)
Hardware Requirements
Minimum 4GB RAM
1GB free disk space
Stable internet connection
Development Environment
For the best development experience, we recommend:
A code editor with TypeScript support (e.g., VS Code)
Terminal access
Git (for version control)
Features
Tools
search_movies
Search for movies by title or keywords
Input:
query
(string): Search queryReturns: List of movies with titles, release years, IDs, ratings, and overviews
Example: Search for movies about space exploration
get_recommendations
Get movie recommendations based on a movie ID
Input:
movieId
(string): TMDB movie IDReturns: Top 5 recommended movies with details
Example: Get recommendations based on movie ID 550 (Fight Club)
get_trending
Get trending movies for a specified time window
Input:
timeWindow
(string): Either "day" or "week"Returns: Top 10 trending movies with details
Example: Get today's trending movies
Resources
The server provides access to TMDB movie information:
Movies (
tmdb:///movie/<movie_id>
)Comprehensive movie details including:
Title and release date
Rating and overview
Genres
Poster URL
Cast information (top 5 actors)
Director
Selected reviews
All data is returned in JSON format
Getting Started
Get a TMDB API key:
Sign up at TMDB
Go to your account settings
Navigate to the API section
Request an API key for developer use
Clone and set up the project:
git clone [repository-url] cd mcp-server-tmdb npm installBuild the server:
npm run buildSet up your environment variable:
export TMDB_API_KEY=your_api_key_here
Usage with Claude Desktop
To integrate this server with Claude Desktop, add the following to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json
):
Replace /full/path/to
with the actual path to your project directory.
Installing via Smithery
To install TMDB Server for Claude Desktop automatically via Smithery:
Example Usage
Once the server is running with Claude Desktop, you can use commands like:
Search for movies:
"Search for movies about artificial intelligence"Get trending movies:
"What are the trending movies today?" "Show me this week's trending movies"Get movie recommendations:
"Get movie recommendations based on movie ID 550"Get movie details:
"Tell me about the movie with ID 550"
Error Handling
The server includes comprehensive error handling for:
Invalid API keys
Network errors
Invalid movie IDs
Malformed requests
Error messages will be returned in a user-friendly format through Claude Desktop.
Development
To watch for changes during development:
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
Related MCP Servers
- -securityAlicense-qualityEnables AI assistants to search and retrieve movie information from The Movie Database (TMDB) API through the Model Context Protocol interface.Last updated -2MIT License
- AsecurityFlicenseAqualityEnables AI assistants like Claude to interact with The Movie Database (TMDB) API, providing capabilities for searching movies, retrieving movie details, and generating customized movie reviews and recommendations.Last updated -42
- -securityFlicense-qualityA Model Context Protocol server that enables searching and retrieving detailed information about movies and TV shows using The Movie Database (TMDB) API.Last updated -1
- -securityAlicense-qualityAn implementation of the Model Context Protocol that provides tools to interact with The Movie Database (TMDB), allowing users to search for movie collaborations, actor filmographies, and other film industry data.Last updated -3MIT License