Imdb MCP Server

[Verified on MCP Review](https://mcpreview.com/mcp-servers/uzaysozen/imdb-mcp-server)

Local serverstdioPython

What is the Imdb MCP server?

Most developer tooling work still happens through a UI a human drives. Imdb MCP server moves it into the conversation instead. Verified on MCP Review.

The short version

This server provides a comprehensive set of tools for accessing IMDb data through the IMDb API. It serves as a bridge between agents and the IMDb database, offering detailed information about movies, TV shows, actors, directors, and more.

  • 🎬 Movie and TV show search capabilities
  • 📋 Detailed information about movies and TV shows
  • 👨‍👩‍👧‍👦 Cast and crew information
  • 🏆 Top-rated and popular content lists
  • 💰 Box office data
  • 🌍 Country-specific movie information (with special focus on Indian cinema)

The tools it exposes

The server publishes 14 tools. What each one is for:

  • search_imdb — Search for movies and TV shows with various filtering options
  • get_imdb_details — Retrieve detailed information about a movie or TV show
  • get_directors — Retrieve the directors of a movie
  • get_cast — Retrieve the cast of a movie
  • get_writers — Retrieve the writers of a movie
  • get_types — Get all available content types
  • get_genres — Get all available genres
  • get_countries — Get all available countries
  • get_languages — Get all available languages
  • get_top_250_movies — Get the top 250 movies from IMDb
  • get_top_box_office_us — Get the US box office records
  • get_most_popular_movies — Get the most popular movies

Getting it running

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: RAPID_API_KEY_IMDB. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Python: 3.13 or higher - Package Manager: uv (recommended) or pip - RapidAPI Account: Required for IMDb API access

How it compares

Among the developer tooling 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. Imdb's toolset — search_imdb, get_imdb_details, get_directors and 11 more — is a fair guide to whether it matches your workflow. It is maintained by uzaysozen; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Imdb's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Imdb.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
search_imdbSearch for movies and TV shows with various filtering options
get_imdb_detailsRetrieve detailed information about a movie or TV show
get_directorsRetrieve the directors of a movie
get_castRetrieve the cast of a movie
get_writersRetrieve the writers of a movie
get_typesGet all available content types
get_genresGet all available genres
get_countriesGet all available countries
get_languagesGet all available languages
get_top_250_moviesGet the top 250 movies from IMDb
get_top_box_office_usGet the US box office records
get_most_popular_moviesGet the most popular movies
get_top_250_tv_showsGet the top 250 TV shows from IMDb
get_most_popular_tv_showsGet the most popular TV shows

How to install the Imdb MCP server

{
  "mcpServers": {
    "imdb_server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/imdb-mcp-server",
        "run",
        "imdb-server"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python: 3.13 or higher - Package Manager: uv (recommended) or pip - RapidAPI Account: Required for IMDb API access
VariableDescriptionRequired
RAPID_API_KEY_IMDBCredential the server authenticates with.Yes

Example prompts to try

  • Use Imdb to search imdb.
  • Use Imdb to get imdb details.
  • Use Imdb to get directors.

Frequently asked questions

It connects Imdb to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_imdb, get_imdb_details, get_directors, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Imdb directly.