Overseerr

★ 1

from jgarciaga

Interact with the Overseerr API to manage movie and TV show requests.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

#git

⌁ labsco summary — our analysis, not the vendor's

What it is — An MCP server for interacting with an Overseerr instance to review movie and TV show requests.

What you get —

overseerr_status — check server status
overseerr_movie_requests / overseerr_tv_requests with filters — e.g. "Show me all the movie requests that are currently pending" or "List all TV show requests from the last month that are now available"

Requirements — A running Overseerr instance, an OVERSEERR_API_KEY (from Overseerr Settings → General) and OVERSEERR_URL.

Cost snapshot — Open source, MIT, free; it fronts your self-hosted Overseerr, so there's no service cost.

Setup effort — Configure uvx overseerr-mcp (or a dev uv --directory command) with the API key and URL in your MCP client.

Our take — Handy for querying your media-request queue in natural language, but it's read/reporting-only in this excerpt (status and listing requests, no approving or creating), and the README states it's "not yet published," so only the development configuration is available.

Source: the project README — summarized 2026-07-08.

⌁ readme from github — mirrored (latest on GitHub ↗)

MCP server for Overseerr

MCP server to interact with Overseerr API for movie and TV show requests management.

Components

Tools

The server implements multiple tools to interact with Overseerr:

overseerr_status: Get the status of the Overseerr server
overseerr_movie_requests: Get the list of all movie requests that satisfies the filter arguments
overseerr_tv_requests: Get the list of all TV show requests that satisfies the filter arguments

Example prompts

It's good to first instruct Claude to use Overseerr. Then it will always call the tool when appropriate.

Try prompts like these:

Get the status of our Overseerr server
Show me all the movie requests that are currently pending
List all TV show requests from the last month that are now available
What movies have been requested but are not available yet?
What TV shows have recently become available in our library?

Development

Building

To prepare the package for distribution:

Sync dependencies and update lockfile:

uv sync

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/overseerr-mcp run overseerr-mcp

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

You can also watch the server logs with this command:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-overseerr-mcp.log

Copy & paste — that's it

{
  "mcpServers": {
    "overseerr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/overseerr-mcp",
        "run",
        "overseerr-mcp"
      ],
      "env": {
        "OVERSEERR_API_KEY": "<your_api_key_here>",
        "OVERSEERR_URL": "<your_overseerr_url>"
      }
    }
  }
}

Before it works, you'll need: OVERSEERR_API_KEYOVERSEERR_URL

Configuration

Overseerr API Key & URL

There are two ways to configure the environment with the Overseerr API credentials:

Add to server config (preferred)

{
  "overseerr-mcp": {
    "command": "uvx",
    "args": [
      "overseerr-mcp"
    ],
    "env": {
      "OVERSEERR_API_KEY": "<your_api_key_here>",
      "OVERSEERR_URL": "<your_overseerr_url>"
    }
  }
}

Create a .env file in the working directory with the following required variables:

OVERSEERR_API_KEY=your_api_key_here
OVERSEERR_URL=your_overseerr_url_here

Note: You can find the API key in the Overseerr settings under "API Keys".

Quickstart

Install

Overseerr API Key

You need an Overseerr instance running and an API key:

Navigate to your Overseerr installation
Go to Settings → General
Find the "API Key" section
Generate a new API key if you don't already have one

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development/Unpublished Servers Configuration

{
  "mcpServers": {
    "overseerr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/overseerr-mcp",
        "run",
        "overseerr-mcp"
      ],
      "env": {
        "OVERSEERR_API_KEY": "<your_api_key_here>",
        "OVERSEERR_URL": "<your_overseerr_url>"
      }
    }
  }
}

Note: This MCP server is not yet published. Currently, only the development configuration is available.