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
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-tmdbsearch for movies about artificial intelligence"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TMDB MCP Server
An MCP server that integrates with The Movie Database (TMDB) API. Provides movie and TV search, streaming availability, cast/crew details, and recommendations — designed for use with AI assistants like Claude.
Tools
Movie Discovery
search_movies — Search by title/keywords → titles, IDs, ratings, overviews
get_trending — Top 10 trending movies (
timeWindow: "day" | "week")search_by_genre — Movies by genre name, optional year filter
advanced_search — Filter by genre, year, min rating, sort, language
search_by_keyword — Find movies by theme/keyword (e.g. "zombie", "heist")
Movie Details
get_movie_details — Full details: cast, crew, runtime, genres, reviews (by
movieId)get_recommendations — Top 5 recommendations based on a movie ID
get_similar_movies — Similar movies via TMDB's similarity algorithm
get_watch_providers — Streaming/rental/purchase availability by country (default: IN)
TV Shows
search_tv_shows — Search TV series by title
get_trending_tv — Top 10 trending TV shows (
timeWindow: "day" | "week")
People
search_person — Find actors, directors, crew by name → ID + known works
get_person_details — Full bio + filmography (movies + TV) by
personId
Resources
tmdb:///movie/<id>— Full movie details in JSON (title, cast, director, reviews, poster URL)
Related MCP server: TMDB MCP Server
Getting Started
Get a TMDB API key at themoviedb.org → Account Settings → API
Clone and build:
git clone https://github.com/Laksh-star/mcp-server-tmdb.git cd mcp-server-tmdb npm install npm run buildSet your API key:
export TMDB_API_KEY=your_api_key_here
Usage with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"tmdb": {
"command": "node",
"args": ["/full/path/to/mcp-server-tmdb/dist/index.js"],
"env": {
"TMDB_API_KEY": "your_api_key_here"
}
}
}
}Usage with BizClaw / NanoClaw
Built into the agent container. Just set TMDB_API_KEY in your .env file — no configuration needed.
Example Prompts
"What's trending in movies this week?"
"Find me Thriller movies from 2023"
"Who is Christopher Nolan and what has he directed?"
"Where can I watch Inception in India?"
"Get details for movie ID 550 (Fight Club)"
"Find movies similar to Interstellar"
"What are the trending TV shows right now?"License
MIT