Skip to content
MCP server

Seerr MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.2.0
Listing updated
4 days ago

About Seerr MCP Server

Seerr MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add seerr-mcp-server --env SEERR_BASE_URL='<SEERR_BASE_URL>' --env SEERR_API_KEY='<SEERR_API_KEY>' -- npx -y @cyanheads/seerr-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/seerr-mcp-server"
      ],
      "env": {
        "SEERR_BASE_URL": "<SEERR_BASE_URL>",
        "SEERR_API_KEY": "<SEERR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/seerr-mcp-server"
      ],
      "env": {
        "SEERR_BASE_URL": "<SEERR_BASE_URL>",
        "SEERR_API_KEY": "<SEERR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "seerr-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/seerr-mcp-server"
      ],
      "env": {
        "SEERR_BASE_URL": "<SEERR_BASE_URL>",
        "SEERR_API_KEY": "<SEERR_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/seerr-mcp-server"
      ],
      "env": {
        "SEERR_BASE_URL": "<SEERR_BASE_URL>",
        "SEERR_API_KEY": "<SEERR_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/seerr-mcp-server"
      ],
      "env": {
        "SEERR_BASE_URL": "<SEERR_BASE_URL>",
        "SEERR_API_KEY": "<SEERR_API_KEY>"
      }
    }
  }
}

Configuration

  • SEERR_BASE_URLBase URL of the Jellyseerr/Overseerr instance, e.g. http://host:5055. No /api/v1 suffix, no trailing slash.Required
  • SEERR_API_KEYSeerr API key (Settings → General → API Key), sent as the X-Api-Key header.Required
  • SEERR_REQUEST_TIMEOUT_MSPer-request HTTP timeout in milliseconds.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • SEERR_BASE_URLBase URL of the Jellyseerr/Overseerr instance, e.g. http://host:5055. No /api/v1 suffix, no trailing slash.Required
  • SEERR_API_KEYSeerr API key (Settings → General → API Key), sent as the X-Api-Key header.Required
  • SEERR_REQUEST_TIMEOUT_MSPer-request HTTP timeout in milliseconds.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Seerr MCP Server FAQ

Is Seerr MCP Server free?

Yes. Seerr MCP Server is open source, so you can use and self-host it for free.

How do I add Seerr MCP Server to Claude Code?

Run this command in your terminal: claude mcp add seerr-mcp-server --env SEERR_BASE_URL='<SEERR_BASE_URL>' --env SEERR_API_KEY='<SEERR_API_KEY>' -- npx -y @cyanheads/seerr-mcp-server