Seerr MCP Server

Search Jellyseerr/Overseerr, check availability, and create guarded media requests.

Remote serverstreamable-http

What is the Seerr MCP Server?

Search Jellyseerr/Overseerr, check availability, and create guarded media requests.

What you get

Configuration and credentials

  • Bun v1.3.2 or higher (or Node.js v24+). - A running Jellyseerr or Overseerr instance, and its API key (Settings → General → API Key).

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
seerr_search_mediaSearch movies and TV by title; returns ranked matches with TMDB ID, year, overview, and decoded availability when Jellyseerr already tracks the title. The required first step before requesting.
seerr_get_mediaFetch exact movie/show details by TMDB ID + media type to confirm the title before a write; for TV, a per-season summary or one season's episode list.
seerr_list_requestsList recent requests with status/type/requester filters; echoes the applied filters and decodes every numeric status. Titles are opt-in via includeTitles.
seerr_request_media**Guarded write.** Previews the request payload by default (mode: preview); creates the request only on mode: request with an elicited confirmation.
seerr_request_statusFetch one request by ID — title, decoded request + media availability (incl. 4K), requester, routing summary, and a state-tuned next-step hint.
seerr_service_optionsSummarize configured Radarr/Sonarr services, default quality profiles, and instance capability flags (4K, partial requests, specials, media server). Filesystem paths redacted unless includePaths.

How to install the Seerr MCP Server

{
  "mcpServers": {
    "seerr-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/seerr-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "SEERR_BASE_URL": "http://localhost:5055",
        "SEERR_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Bun v1.3.2 or higher (or Node.js v24+). - A running Jellyseerr or Overseerr instance, and its API key (Settings → General → API Key).
VariableDescriptionRequired
MCP_TRANSPORT_TYPEConfiguration value read at startup.Optional
MCP_LOG_LEVELConfiguration value read at startup.Optional
SEERR_BASE_URLEndpoint or connection string the server talks to.Yes
SEERR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Seerr to seerr search media.”
  • “Use Seerr to seerr get media.”
  • “Use Seerr to seerr list requests.”

Frequently asked questions

Search Jellyseerr/Overseerr, check availability, and create guarded media requests. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.