Log inSubmit server
Overseerr MCP logo

Overseerr MCP

by jhomen368

Connects AI assistants to Seerr or Overseerr for media search, requests, approvals, details, and Radarr/Sonarr discovery.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Overseerr MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "jhomen368-overseerr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jhomen368/overseerr-mcp"
      ],
      "env": {
        "SEERR_URL": "YOUR_VALUE_HERE",
        "SEERR_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @jhomen368/overseerr-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 24d ago.

Overview

jhomen368/overseerr-mcp MCP server connects AI assistants to Seerr or Overseerr through MCP tools for searching, requesting, and managing movies and TV media. It supports batch searches, deduplication, request validation, request administration, media lookups, and Radarr/Sonarr service discovery. Run it locally with Node.js over stdio or deploy the Docker image with streamable HTTP access. Reach for it when an agent needs to automate media requests or inspect configured download services.

Use cases

  • Search large media lists for existing or pending titles
  • Request movies and selected TV seasons through an assistant
  • Approve or decline queued media requests
  • Inspect Radarr and Sonarr server settings
  • Retrieve media details in batch

Key features

  • Batch media search with deduplication
  • Movie and TV request submission
  • Request approval, decline, and deletion
  • Configurable media detail levels
  • Radarr and Sonarr service discovery
  • Caching with configurable TTLs

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

4/4 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @jhomen368/overseerr-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars25Stargazers on the source repository.
npm downloads735Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Overseerr MCP works

What jhomen368/overseerr-mcp MCP server does

The jhomen368/overseerr-mcp MCP server exposes Seerr and Overseerr operations to MCP-compatible AI clients. It connects to an existing Seerr or Overseerr instance using its URL and API key, then lets an assistant search for media, submit requests, inspect request status, and retrieve media information.

Its scope covers both individual and batch workflows. Search can process multiple titles and includes a deduplication mode intended for checking large lists, with title normalization and franchise-aware results. Request operations support movies, TV shows, selected seasons, or all seasons, with validation and an optional dry-run path. Requests can also be listed, approved, declined, or deleted.

How it works

The server translates MCP tool calls into operations against the configured Seerr or Overseerr API. Six tools are available: search_media, request_media, manage_media_requests, get_media_details, get_services, and get_service_details.

Caching is enabled by default and has separate settings for searches, media, requests, services, and service details. Batch-oriented operations reduce the number of calls needed for title checks and lookups. Request validation includes safeguards for multi-season selections; confirmation is enabled by default when a request exceeds 24 episodes.

The implementation can run as a local Node.js process using stdio, or as a Docker container using streamable HTTP. The container exposes port 8085 by default, with MCP available at /mcp and a health endpoint at /health.

Setup and configuration

To run jhomen368/overseerr-mcp, provide a Seerr or Overseerr URL and an API key created in the instance's General settings. Node.js 18 or newer is required for the package or source-based setup. The documented package installation uses npm install -g @jhomen368/overseerr-mcp, followed by an MCP client configuration that launches it with npx.

Docker users can run the published image and map local port 8085 to the container. This is the documented route for remote HTTP access. Building from source requires cloning the repository, installing dependencies, running the build command, and starting build/index.js.

Use SEERR_URL and SEERR_API_KEY for current configuration. OVERSEERR_URL and OVERSEERR_API_KEY remain supported as deprecated alternatives for legacy deployments. Optional variables control caching, cache durations and size, multi-season confirmation, HTTP mode, and the listening port.

Tools and capabilities

  • search_media: searches one or many titles, with deduplication mode for larger lists and automatic title normalization.
  • request_media: submits movie or TV requests, including chosen seasons or all seasons, with validation and dry-run support.
  • manage_media_requests: lists requests, applies filters, reports summary statistics, and performs approval, decline, or deletion actions.
  • get_media_details: retrieves media data in basic, standard, or full detail levels and supports batch lookups.
  • get_services: discovers configured Radarr and Sonarr servers, including defaults and 4K status.
  • get_service_details: returns server-specific quality profiles, root folders, and tags.

Limitations and notes

The server depends on a reachable Seerr or Overseerr deployment and a valid API key. Network access, firewall rules, and credentials must be configured outside the MCP process. Although the project supports both product names, the legacy OVERSEERR_* variables are scheduled for removal in version 3.0.0, so new setups should use the SEERR_* names.

The available service-management information concerns Radarr and Sonarr configurations exposed through Seerr or Overseerr. Docker health checks confirm the HTTP service is reachable, but they do not validate the upstream API credentials.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Overseerr MCP

jhomen368/overseerr-mcp is an MCP server that connects AI assistants to Seerr or Overseerr. Its main tools search and deduplicate media, submit movie or TV requests, manage existing requests, retrieve media details, and discover Radarr and Sonarr services. It supports local stdio execution and Docker-based streamable HTTP access.

Install it with Node.js 18 or newer using `npm install -g @jhomen368/overseerr-mcp`, then configure an MCP client to launch it with `npx`. You can also run the published Docker image for streamable HTTP, or clone the repository, install dependencies, build, and start the generated entry point.

Set `SEERR_URL` and `SEERR_API_KEY` to connect to your Seerr or Overseerr instance. The server also accepts deprecated `OVERSEERR_URL` and `OVERSEERR_API_KEY` variables for backward compatibility. Optional variables configure caching, HTTP mode, multi-season confirmation, and the port.

Yes, it uses the Model Context Protocol and provides a standard stdio or streamable HTTP connection. The README gives a Claude Desktop configuration example, while the local and Docker transports can be configured in other MCP-compatible clients such as Cursor.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOverseerr MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/jhomen368-overseerr-mcp?style=directory)](https://allmcps.com/mcp/jhomen368-overseerr-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/jhomen368-overseerr-mcp"><img src="https://allmcps.com/api/badge/jhomen368-overseerr-mcp?style=directory" alt="Overseerr MCP on AllMCPs" /></a>