Sonarr

You can manage your Sonarr TV series collection with an MCP server that understands natural language requests. This server acts as a bridge between your Sonarr installation and AI assistants, letting you search, add, update, and monitor series through simple conversations.

How to use

Connect to your local Sonarr MCP server from your preferred MCP client. You can run commands to start the server, then issue high-level requests like searching for a series, adding it with a chosen quality profile, listing all series, updating monitoring settings, or fetching detailed series information. Use natural language prompts similar to your day-to-day conversations with your assistant. For example, you might ask to add a series, request status details, or browse available releases, and the MCP server will carry out the corresponding actions in Sonarr.

How to install

Prerequisites: You need Python 3.13 or newer and access to Sonarr v3+ with API enabled.

Install the MCP server from PyPI (recommended)

pip install sonarr-mcp

Or install from source

git clone https://github.com/MichaelReubenDev/sonarr-mcp.git
cd sonarr-mcp
uv sync

Run the server locally using the standard start command, then connect your MCP clients with the provided URL and API token.

Configuration and usage notes

Required parameters you must provide when connecting a client to Sonarr MCP server:

• --url: Your Sonarr base URL, for example http://localhost:8989
• --api-token: Your Sonarr API token from Settings → General → Security

Optional parameter you can enable for verbose logging:

• --debug: Enable debug logging

Tools and capabilities

The MCP server exposes a set of actions you can request through natural language. Each action maps to a specific operation in Sonarr.

Examples of workflows

Add a new series by instructing your assistant to search for the series, choose a result, and add it with your preferred settings. Then ask to monitor specific seasons or adjust quality profiles as needed.

Available tools

search_series

Search for TV series to add to Sonarr by providing a query string.

add_series

Add a TV series to Sonarr with a specified TVDB ID, quality profile, monitor type, root folder, and optional season monitoring and search options.

list_series

List all TV series currently stored in Sonarr with their details.

get_series

Retrieve detailed information for a specific series by its ID.

update_series

Update settings for an existing series, including quality profile, monitor type, and which seasons to monitor.

delete_series

Delete a series or specific seasons from Sonarr, with optional deletion of files.

interactive_search

Browse available releases for a series, season, or episode with quality and seeder information.

download_release

Manually download a specific release for a series.

get_quality_profiles

List the available quality profiles in Sonarr.