Overseerr MCP Server

MCP server for Overseerr media request management. Enables AI assistants to search for media, view requests, and manage media requests through the Model Context Protocol.

Features

• Search media - Find movies and TV shows by title with availability status

• Media status - Check if content is available, processing, or needs to be requested

• View requests - List requests with user info, filter by approval status, availability status, or time period

• User management - List users and view individual request histories

• Request media - Submit new requests with per-season selection for TV shows

• User correlation - Easily answer questions like "list all requests from the last week and who requested them"

Related MCP server: overseerr-mcp-server

Requirements

• Python 3.10+

• uv package manager

• Overseerr instance with admin API key

Installation

Docker (recommended)

docker pull ghcr.io/suckerfish/overseerr-mcp:latest

From source

git clone https://github.com/suckerfish/overseerr-mcp.git
cd overseerr-mcp

# Create virtual environment and install dependencies
uv venv && uv pip install -e .

Configuration

Copy .env.example to .env and configure:

OVERSEERR_URL=http://your-overseerr-ip:5055
OVERSEERR_API_KEY=your-admin-api-key-here

Important: Use the admin API key from Settings → General → API Key in Overseerr (not a user-level key).

Usage

Local (stdio transport)

uv run python -m src.server

HTTP transport (for Docker/remote)

uv run python -m src.server --transport streamable-http --host 0.0.0.0 --port 8080

Docker

Pre-built images are available for linux/amd64 and linux/arm64.

# Using docker compose (recommended)
docker compose up -d

# Or run directly
docker run -d \
  -e OVERSEERR_URL=http://your-overseerr:5055 \
  -e OVERSEERR_API_KEY=your-api-key \
  -p 8080:8080 \
  ghcr.io/suckerfish/overseerr-mcp:latest

MCP Tools

Example Queries

Once connected to an MCP client, you can ask:

• "Search for The Matrix" - shows availability status inline

• "Is Breaking Bad available?" - checks media status

• "List all requests from the last week and who requested them"

• "Show me all pending requests"

• "What requests are still processing?" - filters by media availability

• "What has user ID 5 requested?"

• "Request the movie The Matrix"

• "Request seasons 1-3 of Breaking Bad" - per-season TV requests

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "overseerr": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.server"],
      "cwd": "/path/to/plexrequest_mcp"
    }
  }
}

HTTP/Docker

{
  "mcpServers": {
    "overseerr": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

License

MIT