TMDB MCP Server
Movie and TV lookup via TMDB, with IMDb, Rotten Tomatoes and Metacritic ratings
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.15.0
- Listing updated
- today
Similar MCP servers
About TMDB MCP Server
TMDB MCP Server is an open-source MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.
This server searches The Movie Database for movies, TV shows and people, and can add IMDb, Rotten Tomatoes and Metacritic scores in the same call using an optional OMDb key. A free TMDB v4 read access token is the only required credential, and language and region can be set for localized results.
Tools cover full details, compact cards for up to 20 ids at a time, cast and crew, recommendations and similar titles, trending lists, theatrical releases, genre references and filmographies. Discover tools filter by genre, dates, rating, cast, companies, keywords, certification and streaming providers, and a watch-provider tool shows where to stream, rent or buy by region. Others return trailers, user reviews, franchise collections and IMDb id lookups.
It runs over stdio through npx, a one-click mcpb bundle or a source build, so it works with clients like Claude Desktop, Cursor and VS Code.
Install
Run in a terminal
claude mcp add tmdb-mcp --env TMDB_API_TOKEN='<TMDB_API_TOKEN>' --env OMDB_API_KEY='<OMDB_API_KEY>' -- npx -y tmdb-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tmdb-mcp": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tmdb-mcp": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tmdb-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tmdb-mcp": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tmdb-mcp": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TMDB_API_TOKENRequired. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).RequiredOMDB_API_KEYOptional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.TMDB_LANGUAGEOptional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).TMDB_REGIONOptional. The user's default country, ISO-3166-1 (e.g. US, GB): ratings, cinemas, where to watch.TMDB_API_TOKENRequired. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).RequiredOMDB_API_KEYOptional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.TMDB_LANGUAGEOptional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).TMDB_REGIONOptional. The user's default country, ISO-3166-1 (e.g. US, GB): ratings, cinemas, where to watch.
Tools this server provides (19)
Taken from the project documentation; the running server may differ.
- search_movies
- Finds movies by name
- search_tv
- Finds TV shows by name
- search_people
- Finds people by name
- search_multi
- Searches movies, TV and people at once
- get_movie
- Full movie details with ratings
- get_tv
- Full TV details with ratings
- get_movies
- Compact cards for up to 20 movies
- get_person
- Biography and links for a person
- get_movie_credits
- Top-billed cast and crew for a movie
- get_similar
- Algorithmically similar titles
- get_trending
- Trending movies, TV and people
- discover_movies
- Filters movies by many criteria
- discover_tv
- Filters TV shows by many criteria
- get_watch_providers
- Where to stream, rent or buy
- get_person_credits
- A person's filmography
- get_videos
- Trailers and clips
- get_reviews
- User reviews
- get_collection
- A franchise and its parts
- find_by_imdb_id
- Resolves an IMDb id
What it does
- Search across media
- Movies, TV, people or all at once.
- Ratings in one call
- IMDb, RT and Metacritic with an OMDb key.
- Discovery filters
- Genre, dates, cast, providers and certification.
- Streaming availability
- Where to watch by region.
- Batch cards
- Compact details for 1 to 20 ids.
- Localization
- Set language and region defaults.
Good for
- Find where a show is streaming
- Compare critics' scores for two films
- Discover highly rated sci-fi from a decade
- See a director's filmography and trailers
Pricing
Open source
Open source; needs free TMDB and optional OMDb keys
TMDB MCP Server FAQ
What credential is required?
A free TMDB v4 Read Access Token.
How do I get IMDb and RT scores?
Add an optional free OMDb API key.
Which clients work?
Any stdio MCP client such as Claude Desktop, Cursor or VS Code.
Can I change language?
Yes, with TMDB_LANGUAGE and TMDB_REGION.
Is TMDB MCP Server free?
Yes. TMDB MCP Server is open source, so you can use and self-host it for free.
How do I add TMDB MCP Server to Claude Code?
Run this command in your terminal: claude mcp add tmdb-mcp --env TMDB_API_TOKEN='<TMDB_API_TOKEN>' --env OMDB_API_KEY='<OMDB_API_KEY>' -- npx -y tmdb-mcp
What are the best alternatives to TMDB MCP Server?
The closest alternatives to TMDB MCP Server are Dostuff, Sf Recpark, Edmtrain, Skiddle and Nyc Parks.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
