TMDB

TMDB

MCP server integrating TMDB API to provide movie information, search, and recommendations.

54
Stars
16
Forks
0
Releases

Overview

TMDB MCP Server provides a bridge between Claude-like clients and The Movie Database (TMDB) API, exposing a set of tools to fetch movie information, search movies by keywords, and obtain personalized or trend-based recommendations. It retrieves comprehensive movie data via the TMDB API and serves it in JSON, including title, release date, rating, overview, genres, poster URL, top 5 cast, director, and selected reviews. The server supports three tools: search_movies (accepts a query and returns a list of matching titles with IDs, years, ratings and overviews), get_recommendations (takes a TMDB movieId and returns top 5 related titles with details), and get_trending (takes a timeWindow of 'day' or 'week' and returns top 10 trending movies). The project uses Node.js and TypeScript, with a setup process that includes obtaining a TMDB API key, cloning, installing dependencies, and building. It can be integrated with Claude Desktop by editing config.json and providing the TMDB_API_KEY, and can be installed via Smithery. The README also outlines error handling, development commands, and licensing.

Details

Owner
Laksh-star
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

search_movies

Search for movies by title or keywords; input query; returns a list of movies with titles, release years, IDs, ratings, and overviews.

get_recommendations

Get movie recommendations based on a movie ID; input movieId; returns top 5 recommended movies with details.

get_trending

Get trending movies for a specified time window; input timeWindow; returns top 10 trending movies.

Audience

DevelopersBuilding apps or assistants that fetch movie data via TMDB through the MCP server.
Claude Desktop usersIntegrating TMDB movie data into Claude Desktop workflows for movie info, search, and recommendations.

Tags

TMDBMovieMCP ServerSearchRecommendationsTrendingClaude DesktopNode.jsTypeScript