Log inSubmit server
Seerr MCP Server logo

Seerr MCP Server

Connects MCP clients to Jellyseerr or Overseerr for media search, availability checks, request previews, and guarded submissions.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Seerr MCP Server

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": {
    "seerr-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/seerr-mcp-server@latest"
      ],
      "env": {
        "SEERR_BASE_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.

bunx @cyanheads/seerr-mcp-server@latest

Process exited before answering 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 Today.

Overview

The seerr-mcp-server MCP server connects MCP clients to Jellyseerr or Overseerr for searching media, checking availability, and managing requests. It validates titles and instance capabilities before writes, while Jellyseerr handles permissions, quotas, routing, and status. The server runs over STDIO or Streamable HTTP and is useful when an agent needs a controlled media-request workflow without calling Radarr or Sonarr directly.

Use cases

  • Search for a movie or show before requesting it
  • Check 4K and standard availability
  • Preview a Radarr or Sonarr request before submission
  • Review request status and routing details
  • Inspect configured services and quality profiles

Key features

  • TMDB-backed movie and TV search
  • Decoded availability and request status
  • Confirmation-gated media requests
  • TV season and episode inspection
  • Radarr and Sonarr service summaries
  • STDIO and Streamable HTTP operation

Tools6

What Seerr MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~278 tokens of context

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.

7/7 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @cyanheads/seerr-mcp-server@latest (npm)

Adoption & maintenance

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

GitHub stars3Stargazers on the source repository.
npm downloads835Package downloads in the last 30 days.
Last commit21d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed6Callable tools this server registers over MCP.

How Seerr MCP Server works

What seerr-mcp-server does

The seerr-mcp-server MCP server exposes Jellyseerr and Overseerr media-request workflows through six MCP tools and one request resource. It searches TMDB-backed movie and TV records, retrieves exact media details, reports availability, inspects existing requests, and submits new requests only through an explicit confirmation flow.

Search is intended to precede a request. Results include ranked matches, TMDB identifiers, year, overview, and decoded availability when Jellyseerr already tracks a title. Exact media lookup can confirm a movie or show before a write. For TV, the lookup can return a season summary or the episodes in one selected season.

Request information includes decoded lifecycle and media statuses, requester identity reduced to an ID and display name, routing details, and a status-dependent next-step hint. The seerr://request/{requestId} resource provides a read-once view equivalent to the request-status tool.

How it works

The server communicates with a configured Jellyseerr or Overseerr instance. Jellyseerr remains responsible for permissions, quotas, routing, and request state; the MCP server does not call Radarr or Sonarr directly.

seerr_request_media is a guarded write. Its default preview mode resolves the title and returns the POST payload that would be sent without changing server state. Request mode requires an accepted confirmation in a live session. Declining, cancelling, or providing an invalid response cancels the operation. Before submission, the server checks cached instance capabilities, including 4K support, valid seasons, and partial-request settings.

TV requests can target all seasons or an explicit list. Optional routing values can select a server, quality profile, root folder, or language profile, while omitted values use Jellyseerr defaults. Existing requests and duplicate-request responses are surfaced rather than silently creating another request.

Setup and configuration

The published installation examples configure the server with npx -y @cyanheads/seerr-mcp-server. Set SEERR_BASE_URL to the Jellyseerr or Overseerr address and SEERR_API_KEY to an API key accepted by that instance.

The server supports STDIO and Streamable HTTP deployments. The guarded request flow is stateful because confirmation must remain associated with a live session. An HTTP deployment configured with MCP_SESSION_MODE=stateless fails at startup instead of exposing a request tool that cannot complete its confirmation step.

Tools and capabilities

  • seerr_search_media searches by title, filters movie or TV results, paginates results, and can apply a language override.
  • seerr_get_media confirms a TMDB ID and media type, including season or episode details for TV.
  • seerr_list_requests filters and sorts requests, paginates results, and optionally joins titles.
  • seerr_request_media previews or submits validated movie and TV requests.
  • seerr_request_status returns request, media, requester, and routing details.
  • seerr_service_options reports configured services, quality profiles, and capability flags. Filesystem paths remain hidden unless explicitly requested.

Limitations and notes

Availability details are returned only when Jellyseerr already tracks the searched title. Request titles are opt-in when listing requests, while request-status lookups join the title automatically when possible. Filesystem paths are redacted by default. A failed Radarr or Sonarr service lookup is reported as a notice where possible rather than invalidating the entire service-options response. Missing media or request IDs are surfaced as typed errors with recovery guidance.

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 Seerr MCP Server

seerr-mcp-server is an MCP server that connects AI clients to Jellyseerr or Overseerr. Its main tools search movies and TV, inspect exact media and availability, list and check requests, summarize service options, and preview or submit guarded media requests through Jellyseerr.

Install it with `npx -y @cyanheads/seerr-mcp-server` through an MCP client configuration. Set `SEERR_BASE_URL` to your Jellyseerr or Overseerr address and `SEERR_API_KEY` to an accepted API key.

Yes, Cursor is named as a supported installation target. Its provided configuration uses the package through `npx` and supplies `SEERR_BASE_URL` and `SEERR_API_KEY` as environment variables.

Yes, requests default to preview mode and require an accepted confirmation before submission. The server also validates instance capabilities and can detect an existing request or map a duplicate rejection to the existing request.

Yes, it supports Streamable HTTP as well as STDIO. The request-confirmation flow requires a stateful session, so an HTTP deployment using `MCP_SESSION_MODE=stateless` fails during startup.

Related MCP servers

All in Other Tools and Integrations 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 PreviewSeerr MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/seerr-mcp-server?style=directory)](https://allmcps.com/mcp/seerr-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/seerr-mcp-server"><img src="https://allmcps.com/api/badge/seerr-mcp-server?style=directory" alt="Seerr MCP Server on AllMCPs" /></a>