playbooks

home / mcp / radarr sonarr mcp server

Radarr Sonarr MCP Server

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

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.