FastMCP server for Overseerr

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.