FastMCP server for Overseerr

Name: FastMCP server for Overseerr
Author: ptbsare

@ptbsare

About FastMCP server for Overseerr

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

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "overseerr-mcp-server-ptbsare": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

Get the status of the Overseerr server.

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).

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).

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.

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.

Search for movies and TV shows available on Overseerr. Accepts `query` and optional `page` (default 1).

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

Get a list of all users configured in Overseerr, including their ID, username, email, displayName, etc.

Overview

What is FastMCP server for Overseerr?

FastMCP server for Overseerr is a server that interacts with the Overseerr API to manage movie and TV show requests. Built with the fastmcp library, it allows AI assistants to query and submit requests to an Overseerr instance.

How to use FastMCP server for Overseerr?

Run the server using uvx (recommended) or clone the repository for local development. Set the OVERSEERR_API_KEY and OVERSEERR_URL environment variables. Add the server to Claude Desktop’s configuration. Then instruct an AI assistant to use the provided tools.

Key features of FastMCP server for Overseerr

Get the status of the Overseerr server.
Search for movies and TV shows available on Overseerr.
Submit movie and TV show requests to specific libraries.
List movie and TV requests with filtering by status and date.
Retrieve configured Sonarr/Radarr libraries and all users.
Request TV shows with optional season selection.

Use cases of FastMCP server for Overseerr

An AI assistant checks the health of the Overseerr server.
A user asks for pending movie or TV show requests.
Submit a request for a specific movie by TMDB ID on behalf of another user.
Search for media and see available libraries and users.
Manage requests for TV shows with selected seasons.

FAQ from FastMCP server for Overseerr

What are the prerequisites?

An Overseerr instance running, an API key (from Settings → API Keys), and uv installed.

How do I run the server without installation?

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

What environment variables are required?

OVERSEERR_API_KEY and OVERSEERR_URL must be set.

What tools are available?

Tools include overseerr_status, overseerr_movie_requests, overseerr_tv_requests, overseerr_request_movie_to_library, overseerr_request_tv_to_library, overseerr_search_media, overseerr_get_available_libraries, and overseerr_get_users.

How do I debug the server?

Use the MCP Inspector via npx @modelcontextprotocol/inspector or check logs (stdout/stderr) and client log files.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K