@striderlabs/mcp-max

MCP (Model Context Protocol) server connector for Max (HBO Max streaming service). Enables AI agents to interact with Max using browser automation via Playwright.

Features

• Search content — Search for movies and TV shows by title, actor, genre, etc.
• Get content details — Retrieve detailed info including description, cast, rating, year, and genre
• View watchlist — Access the user's saved content (My Stuff)
• Add/remove from watchlist — Manage watchlist items
• Continue watching — Get in-progress content with completion percentage
• Viewing history — Access previously watched content

Installation

npm install -g @striderlabs/mcp-max

Or use directly with npx:

npx @striderlabs/mcp-max

Configuration

Add to your MCP client configuration (e.g., Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-max"]
    }
  }
}

Authentication

This connector uses browser automation. To use features that require authentication (watchlist, continue watching, viewing history), you'll need to be logged into Max in the browser session.

The browser runs in headless mode by default. For first-time login, you may need to modify the headless option to false temporarily to complete authentication.

Available Tools

max_search

Search for movies and TV shows.

Parameters:

• query (required): Search terms
• type (optional): "movie", "series", or "all" (default)

max_get_details

Get detailed information about a specific title.

Parameters:

• url (required): Content URL or path (e.g., /movies/the-dark-knight)

max_get_watchlist

Retrieve the user's watchlist (My Stuff). Requires login.

max_add_to_watchlist

Add content to the user's watchlist.

Parameters:

• url (required): Content URL or path

max_remove_from_watchlist

Remove content from the user's watchlist.

Parameters:

• url (required): Content URL or path

max_get_continue_watching

Get in-progress content with completion percentages. Requires login.

max_get_viewing_history

Retrieve viewing history. Requires login.

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/index.js

Requirements

• Node.js 18+
• Playwright (automatically installed as a dependency)

License

MIT