Provides access to TMDB's movie and TV show database, enabling search, detailed information retrieval, discovery with advanced filters, recommendations, cast and crew details, and trending content for movies, TV shows, and entertainment industry professionals.
TMDB MCP Server
A Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables Claude and other MCP clients to search for movies, TV shows, and people, as well as get detailed information and recommendations.
š Now available on the
Quick Start
Get started in seconds with npm:
Get your free TMDB API token: https://www.themoviedb.org/settings/api
Features
š¬ Movie Tools
search_movies - Search for movies by title
get_movie_details - Get detailed information about a specific movie (budget, revenue, runtime, genres, etc.)
discover_movies - Discover movies with advanced filters (genre, language, year range, rating, sorting)
get_recommendations - Get movie recommendations based on a specific movie
get_movie_credits - Get cast and crew information for a movie
šŗ TV Show Tools
search_tv_shows - Search for TV shows by name
get_tv_details - Get detailed information about a specific TV show (seasons, episodes, networks, etc.)
discover_tv_shows - Discover TV shows with advanced filters (genre, language, year, rating, sorting)
get_tv_recommendations - Get TV show recommendations based on a specific show
get_tv_credits - Get cast and crew information for a TV show
š„ People Tools
search_people - Search for actors, directors, and other entertainment industry professionals
get_person_details - Get detailed biographical information about a person
š„ Trending
get_trending - Get daily or weekly trending movies, TV shows, or people
Installation
Option 1: npm (Recommended)
Install from npm registry:
That's it! No build step required.
Option 2: From Source (For Development)
Prerequisites:
Node.js (v18 or higher)
A TMDB API access token (get one free at TMDB)
Steps:
Clone the repository:
Install dependencies:
Create a
.envfile with your TMDB access token:
Build the server:
Usage
With Claude Desktop
Add the server to your Claude Desktop configuration:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
If installed via npm:
If installed from source:
With Other MCP Clients
The server runs on stdio by default, making it compatible with any MCP client that supports stdio transport.
Remote Deployment (HTTP Mode)
The server also supports Streamable HTTP transport for remote deployment:
See TRANSPORT.md for detailed deployment instructions for platforms like Railway.
Development
Local Development
Run the server in watch mode for development:
Debugging
Use the MCP Inspector for debugging:
The Inspector provides a web interface for testing and debugging MCP tools.
Code Formatting
Format code with Prettier:
Example Queries
Here are some example queries you can try with Claude:
"Find Japanese sci-fi movies from 2020 onwards with a rating above 7"
"What are the top trending movies this week?"
"Get me recommendations based on The Matrix"
"Search for Christopher Nolan movies"
"Show me details about the TV show Breaking Bad"
"Find Korean dramas with high ratings"
API Rate Limits
TMDB API has rate limits on their free tier:
50 requests per second
Consider implementing caching for production use
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
See CONTRIBUTING.md for guidelines.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with the Model Context Protocol SDK
Data provided by The Movie Database (TMDB)
This product uses the TMDB API but is not endorsed or certified by TMDB