Sonarr MCP Server

This is a Model Context Protocol (MCP) server for accessing Sonarr. It provides a set of tools for interacting with Sonarr programmatically.

Local serverstdio

What is the Sonarr MCP Server?

Sonarr MCP Server is an MCP project maintained in the jbydeley/sonarr-mcp repository. The maintainer describes its purpose as “This is a Model Context Protocol (MCP) server for accessing Sonarr. It provides a set of tools for interacting with Sonarr programmatically”. Read the project documentation for the complete scope.

Installation

The documented npm package is sonarr-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares SONARR_URL, SONARR_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search-seriesSearch for a TV series by term
find-episodesFind episodes for a series
get-logsGet paginated logs from Sonarr
list-recent-downloadsList recent download history
list-upcoming-episodesList upcoming episodes from the calendar
add-seriesAdd a series to Sonarr

How to install the Sonarr MCP Server

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": [
        "-y",
        "sonarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "YOUR_SONARR_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SONARR_URLDeclared in the maintainer’s client configuration.Yes
SONARR_API_KEYDeclared in the maintainer’s client configuration.Yes