sonarr-mcp

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 and it's awesome!

Tools

The following tools are available:

• add-series: Add a series to Sonarr
• find-episodes: Find episodes in Sonarr
• get-logs: Get paginated logs from Sonarr
• list-recent-downloads: List recent downloads from Sonarr
• list-upcoming-episodes: List upcoming episodes from Sonarr
• search-series: Search for a TV series by term

Resources

The following resources are available:

• episode: Retrieve information about a specific episode by ID
• quality-definition: List quality definitions used by Sonarr
• quality-profiles: List quality profiles configured in Sonarr
• series: Retrieve information about a specific series by ID

Usage

To add this server to your MCP config, add the following:

{
  "mcpServers": {
    "sonarr": {
      "command": "npx",
      "args": ["-y", "sonarr-mcp"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "<your-sonarr-api-key>"
      }
    }
  }
}

You can get your sonarr api key from the sonarr web ui under Settings > API > API Key.

Changelog

1.6.1 (2025-08-13)

Bug Fixes

• 🐛 quiet dotenv (690b31e)

Features

• arch: Simplify and update to latest (a774a19)
• big refactor to simplify architecture (5d12d14)