TM

TMDB

Created 6 months ago

MCP server integrating with The Movie Database (TMDB) API for movie information and recommendations.

development documentation public

What is TMDB?

This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.

Documentation

TMDB MCP Server

Prerequisites

Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:

Required software

  • Node.js - Version 18.0.0 or higher
  • npm (Node Package Manager) - Version 8.0.0 or higher
  • TypeScript - Will be installed as a project dependency

Required accounts & API keys

  • TMDB account - Free account at TMDB

System requirements

  • Operating systems - macOS (10.15 or later), Linux (modern distributions)
  • Hardware requirements - Minimum 4GB RAM, 1GB free disk space

Features# Tools

  • search_movies - Search for movies by title or keywords
  • get_recommendations - Get movie recommendations based on a movie ID
  • get_trending - Get trending movies for a specified time window

Getting started

  1. Get a TMDB API key
  2. Clone and set up the project
  3. Build the server
  4. Set up your environment variable

Usage with Claude Desktop

To integrate this server with Claude Desktop, add the configuration to your app's server configuration file.

Installing via Smithery

To install TMDB Server for Claude Desktop automatically via Smithery.

Example usage

Once the server is running with Claude Desktop, you can use commands like:

Error handling

The server includes comprehensive error handling for various issues.

Development

To watch for changes during development.

License

This MCP server is licensed under the MIT License.

Server Config

{
  "mcpServers": {
    "tmdb-server": {
      "command": "npx",
      "args": [
        "tmdb"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: Laksh-star
Category: community
License: MIT License
Tags:
development documentation public