Laksh-star/mcp-server-tmdb
If you are the rightful owner of mcp-server-tmdb and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
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)
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 build -
Set 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
