TMDB MCP Server
What it does
MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.
- Connects Läuft auf deinem Computer
- Account or key Needs TMDB_API_TOKEN
- Category Spiele, Sport, Essen & Lernen
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Installationsdatei des Anbieters herunterladen
Die .mcpb-Datei des Entwicklers herunterladen
Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht
Datei doppelklicken, dann in der Claude-Desktop-App Install klicken
Ausprobieren
Nutze TMDB MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es TMDB MCP Server nutzt, oder ein Werkzeug von TMDB MCP Server in der Antwort zeigt, bist du verbunden
3 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
OMDB_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). · Standard en-USTMDB_REGIONOptional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results. · Standard US
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann TMDB MCP Server noch nicht verbinden
TMDB MCP Server läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
Das kannst du stattdessen tun
A · Eine App nutzen, die TMDB MCP Server verbinden kann
- Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
- Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
B · Andere in Spiele, Sport, Essen & Lernen, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server TMDB MCP Server für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user tmdb --env TMDB_API_TOKEN=your-value -- npx -y tmdb-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei TMDB_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von TMDB MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
node -vEinmal installieren, gilt für alles, was Node.js braucht
Bei TMDB MCP Server registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --scope user tmdb --env TMDB_API_TOKEN=your-value -- npx -y tmdb-mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
/mcp in Claude Code eingeben
TMDB MCP Server sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze TMDB MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es TMDB MCP Server nutzt, oder ein Werkzeug von TMDB MCP Server in der Antwort zeigt, bist du verbunden
3 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
OMDB_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). · Standard en-USTMDB_REGIONOptional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results. · Standard US
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server TMDB MCP Server für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "tmdb": { "command": "npx", "args": [ "-y", "tmdb-mcp" ], "env": { "TMDB_API_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei TMDB_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von TMDB MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
node -vEinmal installieren, gilt für alles, was Node.js braucht
Bei TMDB MCP Server registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Schlüssel eintragen
In den Einstellungen von TMDB MCP Server ist TMDB_API_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze TMDB MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es TMDB MCP Server nutzt, oder ein Werkzeug von TMDB MCP Server in der Antwort zeigt, bist du verbunden
3 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
OMDB_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). · Standard en-USTMDB_REGIONOptional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results. · Standard US
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von TMDB MCP Server (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server TMDB MCP Server für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "tmdb": { "type": "stdio", "command": "npx", "args": [ "-y", "tmdb-mcp" ], "env": { "TMDB_API_TOKEN": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei TMDB_API_TOKEN "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von TMDB MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Node.js installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -v- Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
node -vEinmal installieren, gilt für alles, was Node.js braucht
Bei TMDB MCP Server registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Schlüssel eintragen
In den Einstellungen von TMDB MCP Server ist TMDB_API_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze TMDB MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es TMDB MCP Server nutzt, oder ein Werkzeug von TMDB MCP Server in der Antwort zeigt, bist du verbunden
3 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
OMDB_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). · Standard en-USTMDB_REGIONOptional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results. · Standard US
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Auf deinem Computer installiert
Claude Code
claude mcp add --scope user tmdb --env TMDB_API_TOKEN=your-value -- npx -y tmdb-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"tmdb": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"tmdb": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"tmdb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "your-value"
}
}
}
}Werte, die du selbst einträgst
TMDB_API_TOKENgeheim erforderlich envRequired. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).OMDB_API_KEYgeheim envOptional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.TMDB_LANGUAGEenvOptional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).TMDB_REGIONenvOptional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results.
Die Beschreibungen sind noch im englischen Original.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 15. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto Grinv bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 24 Tagen
- ✓ Bestanden
Hat eine Lizenz
Nutzt MIT
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni
- Mehr Sterne als 94 % der anderen 1498 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 53 % der anderen 1498 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1498 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist TMDB MCP Server sicher?
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: TMDB_API_TOKEN
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vor 24 Tagen geändert, und die neueste Version (0.14.0) kam vor 24 Tagen in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js, MCPB auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Ähnliche Alternativen
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
- Anime Garden — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig
- WilmAI — Wird auf deinem Rechner installiert · Kein Schlüssel nötig
- Lumify Sports Intelligence — Läuft in der Cloud, keine Installation · Braucht einen Schlüssel
- Savecraft — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig
- GoodWatch — Läuft in der Cloud, keine Installation · Kein Schlüssel nötig
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
TMDB MCP Server
An MCP server for The Movie Database (TMDB): search and look up movies, TV shows and people, and read IMDb / Rotten Tomatoes / Metacritic ratings (via OMDb) in the same call.
The server speaks standard MCP over stdio, so it works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …).
Once it's connected, just ask your agent in natural language (needs a free TMDB token; see Getting your credentials):
"Search for the movie Dune: Part Two and show its overview, genres and runtime."
"What movies are trending this week?" "Find TV shows similar to Breaking Bad." "Who directed Oppenheimer? Show the main cast." "What's Greta Gerwig's filmography?" "Discover highly-rated sci-fi movies from the 2010s, sorted by rating." "Where can I stream The Bear in the US?" "Show me the trailer for Deadpool & Wolverine." "List the episodes of Severance season 1." "Which movie has IMDb id tt0111161?" "Search for people named Zendaya." "Get the year, genres and rating for these five movies in one go: Dune, Dune: Part Two, Arrival, Sicario and Blade Runner 2049." "What are the best limited series to binge over a weekend?" "What TV shows can I watch with my 9-year-old kid?" "What movies has A24 produced?" "What are Tarantino's best-rated crime movies?" "Who composed the music for My Neighbor Totoro, and what else has he scored?"
With an optional (free) OMDb key, ratings are added too:
"What are the IMDb, Rotten Tomatoes and Metacritic scores for The Godfather?"
"Compare the critics' scores for Barbie and Oppenheimer."
Install
Add it to your MCP client's config. The only required credential is a TMDB v4 Read Access Token; OMDB_API_KEY (ratings) and TMDB_LANGUAGE / TMDB_REGION (localization) are optional.
Via npx (no install):
{
"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)" } } } }
Replace each value with your own. Only
TMDB_API_TOKENis required; delete the
lines marked optional if you don't need them.
As a `.mcpb` bundle (easiest for Claude Desktop): download tmdb-mcp.mcpb from the latest release, then open it / drag it into Claude Desktop's Extensions. It's a self-contained bundle (no Node or npm needed); enter the token and the optional fields in the install dialog. Re-download and reinstall to update.
From source: git clone, then npm ci && npm run build, and point the client at it with "command": "node", "args": ["/ABS/PATH/tmdb-mcp/dist/index.js"] and the same env as above.
See docs/clients.md for per-client details and all tunables.
What it does
| Tool | Purpose |
|---|---|
search_movies / search_tv / search_people | Find titles/people by name → TMDB id |
search_multi | Search movies, TV and people at once (each row has a media_type) |
get_movie / get_tv | Full details + IMDb/RT/Metacritic ratings (toggle with include_ratings) |
get_movies / get_tv_shows | Compact card(s) (title/year/genres/vote average, ratings opt-in) for 1-20 ids in one call |
get_person | Biography, department, links |
get_movie_credits / get_tv_credits | Top-billed cast and headline crew (TV: whole run, ranked by episode count) |
get_movie_recommendations / get_tv_recommendations | Recommendations from co-viewing data (what fans also liked) |
get_similar | Algorithmically similar titles (media_type + id) |
get_trending | What's popular now (movies / TV / people, day or week) |
get_movie_releases | Movies in cinemas now (now_playing) or opening soon (upcoming) in a country, with TMDB's date window |
get_movie_genres / get_tv_genres | Genre id ↔ name reference |
discover_movies | Filter by genre, date range, rating, cast/crew, companies, origin country, keywords, providers (+/-, access type), certification, regional release dates |
discover_tv | Same, plus networks/type/status and episodes airing in a date range, but no cast/crew/person or regional release-date filter (use get_person_credits for people) |
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 |
get_tv_season / get_tv_episode | Season episode list / single-episode details |
search_keywords | Resolve keyword names → ids for discover_* |
search_companies | Resolve a production company name → id for discover_*'s with_companies |
search_collections | Resolve a franchise name (e.g. 'harry potter') → collection id for get_collection |
search_watch_providers | Resolve a streaming/rental service name (e.g. 'Netflix') → id for discover_*'s with_watch_providers |
get_ratings | IMDb/RT/Metacritic ratings by IMDb id or title (standalone) |
Prompts. Alongside the tools above, the server exposes two MCP prompts: recommend_similar (title, optional media_type, optional count) plans a search for titles similar to one the user liked, driving get_similar / get_movie_recommendations / get_tv_recommendations / discover_movies / discover_tv instead of relying on the model's own knowledge. top_by_entity (name, optional entity_type, genre, media_type, count) finds the best-regarded titles from a person or a production company/studio (e.g. "A24's top movies" or "Tarantino's best crime films") via discover_movies/ discover_tv, and for a person's TV work specifically falls back to get_person_credits (TMDB's own /discover/tv can't filter by person at all).
Backbone vs. enrichment. TMDB is the primary source (search, metadata, people, trending). OMDb is optional enrichment: get_movie/get_tv chain the imdb_id TMDB returns into an OMDb lookup, so ratings come back in one call, along with a free-text awards summary (major-award wins/nominations, e.g. Oscars for a film or Emmys for a show, for the title as a whole, not attributed to any one person) and OMDb's own age rating (ratings.rated, separate from this server's own certification). Without an OMDb key the TMDB data still works; the ratings field just reports that it is unconfigured.
Localization. Set TMDB_LANGUAGE (e.g. ru-RU) and TMDB_REGION (e.g. RU) to get localized titles/overviews/genre names and region-specific certifications. search_movies/search_tv/search_multi/search_people/ search_collections, get_movie/get_tv/get_movies/get_tv_shows/get_person, get_collection, get_movie_releases and discover_movies/discover_tv also accept a per-call language override.
Getting your credentials
One token is required (TMDB); the OMDb key is optional. Both are free.
- TMDB token (required). Create a free account at themoviedb.org, then open [Settings → API](https://www.themoviedb.org/settings/api) and request an API key (personal use). Copy the **"API Re