Overseerr-MCP-Server
by ptbsare
FastMCP server to interact with the Overseerr API for movie and TV show requests management, built using the `fastmcp` library. It provides tools to manage Overseerr requests via an MCP interface.
Last updated: N/A
What is Overseerr-MCP-Server?
This is a FastMCP server designed to interact with the Overseerr API. It allows you to manage movie and TV show requests within Overseerr through a Model Context Protocol (MCP) interface.
How to use Overseerr-MCP-Server?
To use this server, you need to configure it with your Overseerr API key and URL, either through environment variables or by adding it to your client's MCP server configuration. You can then use an MCP client (like Claude Desktop) to send commands to the server, which will then interact with the Overseerr API on your behalf.
Key features of Overseerr-MCP-Server
Get Overseerr server status
Retrieve paginated lists of movie and TV show requests
Submit movie and TV show requests to specific libraries on behalf of users
Search for media available on Overseerr
Retrieve configured Sonarr and Radarr server IDs and names
Get a list of all users configured in Overseerr
Use cases of Overseerr-MCP-Server
Automating media requests through an AI assistant
Integrating Overseerr management into custom workflows
Querying the status of media requests programmatically
Searching for available media within Overseerr via a conversational interface
FAQ from Overseerr-MCP-Server
How do I find my Overseerr API key?
How do I find my Overseerr API key?
You can find the API key in the Overseerr settings under 'API Keys'.
What is the purpose of the MCP Inspector?
What is the purpose of the MCP Inspector?
The MCP Inspector is a tool that helps debug MCP servers by allowing you to inspect the communication between the client and the server.
How do I configure the server with my Overseerr API key and URL?
How do I configure the server with my Overseerr API key and URL?
You can configure the server either by adding the API key and URL to your client's MCP server configuration or by creating a .env file in the root directory of the repository.
What is the required Python version?
What is the required Python version?
Python version 3.12 or greater is required.
What is uv and how do I install it?
What is uv and how do I install it?
uv is a fast package installer and resolver for Python. Installation instructions can be found at https://github.com/astral-sh/uv.