Movie Rec MCP Server

A Model Context Protocol (MCP) server that tracks movies, books, and TV shows, providing intelligent recommendations based on your preferences. Built

Local serverstdio

What is the Movie Rec MCP Server?

A Model Context Protocol (MCP) server that tracks movies, books, and TV shows, providing intelligent recommendations based on your preferences. Built with Bun

What you get

  • Multi-Media Tracking — Track movies, books, and TV shows with ratings, status, and notes
  • Smart Filtering — List media by type, status, rating, genre, and more
  • Cross-Media Recommendations — Get suggestions based on your preferences across all media types
  • Rich Metadata — Automatic metadata fetching from OMDB (movies), Google Books (books), and TMDB (TV shows)
  • Preference Analysis — Understand your favorite genres, creators, and what you typically enjoy
  • Persistent Storage — SQLite database with Drizzle ORM and proper relations

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_and_add_movieSearch for a movie and add it with auto-populated metadata from OMDB.
search_and_add_bookSearch for a book and add it with auto-populated metadata from Google Books.
search_and_add_tv_showSearch for a TV show and add it with auto-populated metadata from TMDB.
list_media
add_movie_to_watchlist
get_smart_recommendationsGet intelligent recommendations based on your preferences across all media types.
mark_as_watched
analyze_preferences
update_movie

How to install the Movie Rec MCP Server

{
  "mcpServers": {
    "mediasage": {
      "command": "bun",
      "args": ["run", "/path/to/mediasage/index.ts"]
    }
  }
}

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

Configuration

VariableDescriptionRequired
API_KEYCredential the server authenticates with.Yes
PORTConfiguration value read at startup.Optional
OMDB_API_KEYCredential the server authenticates with.Yes
TMDB_API_KEYCredential the server authenticates with.Yes
GOOGLE_BOOKS_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Movie Rec MCP to search and add movie.”
  • “Use Movie Rec MCP to search and add book.”
  • “Use Movie Rec MCP to search and add tv show.”

Frequently asked questions

A Model Context Protocol (MCP) server that tracks movies, books, and TV shows, providing intelligent recommendations based on your preferences. Built with Bun Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.