overseerr-mcp-server
The server is an MCP toolset for interacting with a Seerr/Overseerr instance to manage media requests and queries.
Check the health/status of the Seerr/Overseerr server
List movie requests with optional filters by status or start date, with pagination controls
List TV show requests with optional filters by status or start date, with pagination controls
Submit movie requests to a specific library on behalf of a user using a TMDB ID
Submit TV show requests to a specific library on behalf of a user using a TMDB ID, optionally specifying seasons
Search for movies and TV shows available on the Seerr/Overseerr instance
Get configured Sonarr (TV) and Radarr (Movie) libraries
Get the list of users configured in Seerr/Overseerr
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@overseerr-mcp-server search for Dune Part Two on Overseerr"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 optionalstatus,start_date(YYYY-MM-DDTHH:MM:SS.mmmZ format),take(default 7), andskip(default 0).seerr_tv_requests: Get a paginated list of TV show requests. Accepts optionalstatus,start_date(YYYY-MM-DDTHH:MM:SS.mmmZ format),take(default 7), andskip(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. Requirestmdb_id,library_name, anduser_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. Requirestmdb_id,library_name, anduser_display_name. Optionally acceptsseasons(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. Acceptsqueryand optionalpage(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
uv(installation instructions: https://github.com/astral-sh/uv)An Seerr instance running.
API Key from your Seerr instance (Settings → API Keys).
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-serverClaude 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:5055Local 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-serverAccess 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.logon macOS, but the name might vary based on your config).
License
MIT
Available Tools
8 toolsoverseerr_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
Scored across 8 tools
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.
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.
8 tools is well-scoped for an Overseerr media request management server. Each tool covers a necessary function without redundancy.
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
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Overseerr media request management through natural language. Supports searching for movies/TV shows, managing media requests, approving/denying requests, and monitoring server status.MIT
- AlicenseAqualityCmaintenanceMCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.12MIT
- AlicenseNot gradedqualityAmaintenanceEnables searching Overseerr media, retrieving TMDB-backed details, and submitting movie or TV requests through MCP tools.5MIT
- FlicenseNot gradedqualityBmaintenanceMCP 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.-