Overseerr

MCP Server für Overseerr

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "edemal-mcp-server-overseerr": {
      "command": "node",
      "args": [
        "path/to/overseerr-mcp-server/build/index.js"
      ],
      "env": {
        "OVERSEERR_API_KEY": "YOUR_API_KEY",
        "OVERSEERR_BASE_URL": "http://localhost:5055"
      }
    }
  }
}

You can run an Overseerr MCP Server locally to access Overseerr features through Claude and compatible AI assistants. This MCP server exposes media search, requests management, media details, and server status, letting you control Overseerr from chat-based workflows.

How to use

Connect your MCP client to the Overseerr MCP Server to perform practical tasks such as searching for films or TV series, listing and filtering user requests, submitting new media requests, approving or denying pending requests, and retrieving detailed media information. You can also check the Overseerr server status and view requests for individual users. Use natural language prompts like: search for a movie, show me pending requests, or show me media details for a title.

How to install

Prerequisites: you need Node.js and npm installed on your system. Make sure you have a supported shell access to run commands.

mkdir overseerr-mcp-server
cd overseerr-mcp-server

Create or copy the MCP server code into the project structure, placing the TypeScript entry at src/index.ts and including the other configuration files as needed.
Install dependencies

npm install

Build the project

npm run build

Claude Desktop Integration

Configure Claude Desktop to connect to the Overseerr MCP Server by adding an MCP server entry in your Claude configuration.

{
  "mcpServers": {
    "overseerr": {
      "command": "node",
      "args": ["path/to/overseerr-mcp-server/build/index.js"],
      "env": {
        "OVERSEERR_API_KEY": "your_api_key_here",
        "OVERSEERR_BASE_URL": "http://localhost:5055"
      }
    }
  }
}

Configuration overview

Set the Overseerr API key and the base URL so the MCP server can communicate with your Overseerr instance.

Troubleshooting

Common issues include missing API keys or connectivity problems. Ensure the environment variables are set and Overseerr is reachable at the configured base URL. If you encounter authentication errors, verify that the API key has the necessary permissions.

For more detailed debugging, run the server in development mode and inspect the logs for errors related to API access or network connectivity.

Development

During development you can use the Dev mode to run and test changes quickly.

npm run dev

License

MIT License - see LICENSE for details.

Available tools

search_media

Searches for films and TV series in the TMDB database using the Overseerr MCP Server.

get_requests

Retrieves all media requests with optional filtering, paging, and sorting.

request_media

Submits a new media request by TMDB ID, type (movie or tv), optional seasons, and 4K flag.

approve_request

Approves a specified media request by its ID.

deny_request

Denies a specified media request by its ID, with an optional reason.

get_media_details

Fetches detailed information for a specific movie or TV title by TMDB ID.

get_server_status

Returns current status and information about the Overseerr MCP Server.

get_user_requests

Shows requests associated with a specific user ID, with optional paging.