MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.
MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb. The tmdb mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.
The server speaks standard MCP over stdio, so it works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …).
The server ships on npm as tmdb-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Everything the assistant can do here goes through one of these:
search_multi — Search movies, TV and people at once (each row has a media_type)get_person — Biography, department, linksget_similar — Algorithmically similar titles (media_type + id)get_trending — What's popular now (movies / TV / people, day or week)discover_movies — Filter by genre, year/date range, rating, cast/crew/people, companies, keywords, providers, certification, …discover_tv — Same, plus networks/type/status — but no cast/crew/person filter (use get_person_credits for that)get_watch_providers — Where to stream/rent/buy, by region (JustWatch via TMDB)get_person_credits — A person's filmography (cast & crew)get_videos — Trailers/teasers/clips (YouTube links)get_reviews — User reviews (author, rating, text) for a movie/TVget_collection — A movie franchise/collection and its parts, in release orderfind_by_imdb_id — Resolve an IMDb id → TMDB movie/TV/personYou will need 6 environment variables: TMDB_API_TOKEN, OMDB_API_KEY, TMDB_LANGUAGE, TMDB_REGION, TMDB_BASE_URL, OMDB_BASE_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the database access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Tmdb's toolset — search_multi, get_person, get_similar and 11 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Tmdb's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| search_multi | Search movies, TV and people at once (each row has a media_type) |
| get_person | Biography, department, links |
| get_similar | Algorithmically similar titles (media_type + id) |
| get_trending | What's popular now (movies / TV / people, day or week) |
| discover_movies | Filter by genre, year/date range, rating, cast/crew/people, companies, keywords, providers, certification, … |
| discover_tv | Same, plus networks/type/status — but no cast/crew/person filter (use get_person_credits for that) |
| get_watch_providers | Where to stream/rent/buy, by region (JustWatch via TMDB) |
| get_person_credits | A person's filmography (cast & crew) |
| get_videos | Trailers/teasers/clips (YouTube links) |
| get_reviews | User reviews (author, rating, text) for a movie/TV |
| get_collection | A movie franchise/collection and its parts, in release order |
| find_by_imdb_id | Resolve an IMDb id → TMDB movie/TV/person |
| search_keywords | Resolve keyword names → ids for discover_* |
| search_companies | Resolve a production company name → id for discover_*'s with_companies |
{
"mcpServers": {
"tmdb": {
"command": "npx",
"args": ["-y", "tmdb-mcp"],
"env": {
"TMDB_API_TOKEN": "your-tmdb-v4-read-access-token (required)",
"OMDB_API_KEY": "your-omdb-key (optional — IMDb/RT/Metacritic ratings)",
"TMDB_LANGUAGE": "en-US (optional — localize, e.g. ru-RU)",
"TMDB_REGION": "US (optional — region for certifications, e.g. RU)"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| TMDB_API_TOKEN | Credential the server authenticates with. | Yes |
| OMDB_API_KEY | Credential the server authenticates with. | Yes |
| TMDB_LANGUAGE | Configuration value read at startup. | Optional |
| TMDB_REGION | Configuration value read at startup. | Optional |
| TMDB_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| OMDB_BASE_URL | Endpoint or connection string the server talks to. | Yes |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.