Radarr Sonarr

Provides an MCP server to access Radarr movies and Sonarr TV shows data for AI assistants.

python

25

GitHub Stars

python

Language

6 months ago

First Indexed

2 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": {
    "berrykuipers-mcp_services_radarr_sonarr": {
      "command": "radarr-sonarr-mcp",
      "args": [
        "start"
      ]
    }
  }
}

You run a Python-based MCP server that lets AI assistants access your Radarr movie collection and Sonarr TV shows data. It exposes a standard interface so Claude Desktop and other MCP clients can query your media library securely and efficiently, with rich filtering and easy setup.

How to use

Connect your MCP client to the server to start asking about your media. You can search for movies and series, filter results by year, watched status, actors, and more, and request detailed information or episode lists. Use natural language queries like asking for specific genres, years, or actors, and let the MCP translate your request into Radarr/Sonarr API calls.

How to install

Prerequisites: you need Python 3.7+ and internet access to install dependencies.

Install the MCP package and its dependencies, then run the setup and start the server with the provided CLI tools.

Configuration and running

Configure the server to connect to Radarr and Sonarr, then start the MCP server so clients can connect.

radarr-sonarr-mcp configure

Follow the prompts to enter your Radarr and Sonarr API keys and network settings.

## Security and maintenance

Run the server on a trusted local network. Regularly rotate API keys for Radarr and Sonarr and monitor access from MCP clients to maintain security.

## Notes

The server supports a CLI workflow for quick setup and a standard MCP interface for client compatibility. You can also start the server directly during development to test features.

## Available tools

### get\_available\_movies

Return a list of movies with optional filters such as year, watched, downloaded, watchlist, and actors.

### lookup\_movie

Search for a movie by title and return matching results.

### get\_movie\_details

Fetch detailed information for a specific movie by identifier.

### get\_available\_series

Return a list of TV series with optional filters such as year, watched, downloaded, watchlist, and actors.

### lookup\_series

Search for a TV series by title and return matching results.

### get\_series\_details

Fetch detailed information for a specific series by identifier.

### get\_series\_episodes

Retrieve the list of episodes for a specific series.

### /movies

Endpoint to browse all available movies.

### /series

Endpoint to browse all available TV series.