Skip to main content
Glama
overseerr-mcp-server

overseerr-mcp-server

by ptbsare

FastMCP server for Seerr

FastMCP server to interact with the Seerr API for movie and TV show requests management, built using the fastmcp library.

Project Repository: https://github.com/ptbsare/seerr-mcp-server

Components

Tools

The server implements the following tools to interact with Seerr:

  • seerr_status: Get the status of the Seerr server.

  • seerr_movie_requests: Get a paginated list of movie requests. Accepts optional status, start_date (YYYY-MM-DDTHH:MM:SS.mmmZ format), take (default 7), and skip (default 0).

  • seerr_tv_requests: Get a paginated list of TV show requests. Accepts optional status, start_date (YYYY-MM-DDTHH:MM:SS.mmmZ format), take (default 7), and skip (default 0).

  • seerr_request_movie_to_library: Submit a movie request using its TMDB ID to a specific library, on behalf of a specific user. Requires tmdb_id, library_name, and user_display_name. Available library names and user display names (unique ones only) are fetched at server startup and included in the tool's argument descriptions.

  • seerr_request_tv_to_library: Submit a TV show request using its TMDB ID to a specific library, on behalf of a specific user. Requires tmdb_id, library_name, and user_display_name. Optionally accepts seasons (list of integers). Available library names and user display names (unique ones only) are fetched at server startup and included in the tool's argument descriptions.

  • seerr_search_media: Search for movies and TV shows available on Seerr. Accepts query and optional page (default 1).

  • seerr_get_available_libraries: Get the configured Sonarr (TV) and Radarr (Movie) server IDs and names from Seerr.

  • seerr_get_users: Get a list of all users configured in Seerr, including their ID, username, email, displayName, etc.

Example prompts

It's good to first instruct your AI assistant (e.g., Claude) to use the Seerr tools. Then it can call the appropriate tool when needed.

Try prompts like these:

  • Get the status of our Seerr server.

  • Show me the first 5 movie requests that are currently pending.

  • List all TV show requests from 2024-01-01 that are now available.

  • What movies have been requested but are not available yet?

  • What TV shows have recently become available in our library?

  • Search for the movie "Dune: Part Two" on Seerr.

  • What movie and TV libraries are configured in Seerr?

  • List all users in Seerr.

  • Request the movie with TMDB ID 693134 for the user 'John Doe' in the 'Movies HD' library. (Uses user_display_name='John Doe', library_name='Movies HD')

  • Request seasons 1 and 2 for the TV show with TMDB ID 1396 for user 'Jane Smith' in the 'TV Shows 4K' library. (Uses user_display_name='Jane Smith')

Related MCP server: nas-mcp-server

Quickstart

Prerequisites

Run with uvx (Recommended - No Installation Required)

You can run the server directly from the git repository using uvx — no clone or install needed:

uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "seerr-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ptbsare/seerr-mcp-server.git",
        "seerr-mcp-server"
      ],
      "env": {
        "SEERR_API_KEY": "<your_api_key_here>",
        "SEERR_URL": "<your_seerr_url>"
      }
    }
  }
}

Replace <your_api_key_here> and <your_seerr_url> with your actual Seerr API key and URL.

Environment Variables

The following environment variables are required:

  • SEERR_API_KEY: Your Seerr API key (found in Seerr Settings → API Keys)

  • SEERR_URL: The URL of your Seerr instance (e.g., http://localhost:5055)

For clients like Claude Desktop, add these to the env field as shown above. For local use, you can export them or use a .env file:

SEERR_API_KEY=your_api_key_here
SEERR_URL=http://localhost:5055

Local Development Installation

If you prefer to install locally for development:

git clone https://github.com/ptbsare/seerr-mcp-server.git
cd seerr-mcp-server
uv venv
source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
uv pip install -e .

Development

Setup

Follow the installation steps using uv pip install -e . for an editable install.

Dependencies

Install or sync dependencies using uv:

uv sync
# or
uv pip install -e .

Debugging

Since MCP servers run over stdio, debugging can be challenging.

  • MCP Inspector: The MCP Inspector is highly recommended.

    Launch it pointing to your server script:

    # Using uvx (no local installation needed)
    npx @modelcontextprotocol/inspector uvx --from git+https://github.com/ptbsare/seerr-mcp-server.git seerr-mcp-server
    
    # Or using uv run (from local project directory)
    npx @modelcontextprotocol/inspector uv run seerr-mcp-server

    Access the URL provided by the Inspector in your browser.

  • Logging: The server logs basic information to stdout/stderr. Check the terminal where you ran uv run seerr-mcp-server. For clients like Claude Desktop, check the client's log files (e.g., ~/Library/Logs/Claude/mcp-server-seerr-mcp.log on macOS, but the name might vary based on your config).

License

MIT

Available Tools

8 tools
overseerr_get_available_librariesA

Get the configured Sonarr (TV) and Radarr (Movie) server IDs and names from Overseerr.

Inputs: no named parameters.

overseerr_get_usersA

Get a list of all users configured in Overseerr.

Inputs: no named parameters.

overseerr_movie_requestsA

Get a paginated list of movie requests that satisfy the filter arguments.

Args:
    status (Optional[str]): Filter by media availability status (e.g., "pending", "available", "approved"). Valid values: "all", "approved", "available", "pending", "processing", "unavailable", "failed". Defaults to all if omitted or invalid.
    start_date (Optional[str]): Filter for requests created on or after this date, formatted as 'YYYY-MM-DDTHH:MM:SS.mmmZ'.
    take (Optional[int]): The number of results to return (page size). Defaults to 7.
    skip (Optional[int]): The number of results to skip (for pagination). Defaults to 0.

Inputs: skip, take, status, start_date.

overseerr_request_movie_to_libraryA

Submit a movie request to a specific Overseerr library identified by its name, on behalf of a specific user.

Args: tmdb_id (int): The The Movie Database (TMDB) ID of the movie to request. library_name (str): The name of the target Radarr (Movie) library configured in Overseerr. Must match exactly. Available: None fetched. user_display_name (str): The exact display name of the Overseerr user making the request. Available: None fetched (or duplicates exist).

Inputs: tmdb_id (required), library_name (required), user_display_name (required).

overseerr_request_tv_to_libraryA

Submit a TV show request to a specific Overseerr library identified by its name, on behalf of a specific user.

Args: tmdb_id (int): The The Movie Database (TMDB) ID of the TV show to request. library_name (str): The name of the target Sonarr (TV) library configured in Overseerr. Must match exactly. Available: None fetched. user_display_name (str): The exact display name of the Overseerr user making the request. Available: None fetched (or duplicates exist). seasons (Optional[List[int]]): List of season numbers to request. If omitted or empty, all seasons will be requested.

Inputs: tmdb_id (required), library_name (required), user_display_name (required), seasons.

overseerr_search_mediaB

Search for movies and TV shows available on Overseerr.

Args:
    query (str): The search term (e.g., movie or TV show title).
    page (int): The page number for pagination (default is 1).

Inputs: query (required), page.

overseerr_statusA

Get the status of the Overseerr server. No arguments required.

Inputs: no named parameters.

overseerr_tv_requestsA

Get a paginated list of TV show requests that satisfy the filter arguments.

Args:
    status (Optional[str]): Filter by media availability status (e.g., "pending", "available", "approved"). Valid values: "all", "approved", "available", "pending", "processing", "unavailable", "failed". Defaults to all if omitted or invalid.
    start_date (Optional[str]): Filter for requests created on or after this date, formatted as 'YYYY-MM-DDTHH:MM:SS.mmmZ'.
    take (Optional[int]): The number of results to return (page size). Defaults to 7.
    skip (Optional[int]): The number of results to skip (for pagination). Defaults to 0.

Inputs: skip, take, status, start_date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: user management, server status, request retrieval for movies/TV, request submission for movies/TV, media search, and library configuration. No overlapping tools.

    Naming Consistency4/5

    All tools share the 'overseerr_' prefix, and most follow a verb_noun pattern (get_users, search_media, request_movie_to_library). However, 'status' and 'movie_requests' are nouns without a leading verb, making the pattern slightly inconsistent.

    Tool Count5/5

    8 tools is well-scoped for an Overseerr media request management server. Each tool covers a necessary function without redundancy.

    Completeness4/5

    The tool set covers core workflows: searching, requesting, listing requests, and fetching context (users, libraries, status). Missing update/delete or approval actions for requests, but the primary request lifecycle is represented.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
      12
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables searching Overseerr media, retrieving TMDB-backed details, and submitting movie or TV requests through MCP tools.
      5
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Overseerr that enables searching, requesting, and managing media (movies and TV shows) through natural language, with integration to Radarr/Sonarr for automated downloads.
      -