MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery

Crave automated media mastery? MCP Server streamlines Radarr & Sonarr—zero hassle, all your movies and shows, delivered seamlessly. Made for true fans.

Visit Repository

✨ Developer Tools

4.6(16 reviews)

24 saves

11 comments

Ranked in the top 9% of all AI tools in its category

About MCP Radarr & Sonarr Server

What is MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery?

MCP Radarr & Sonarr Server is a centralized automation hub designed to unify your media management workflows. By seamlessly integrating with Radarr and Sonarr, it eliminates the need for juggling multiple interfaces. This solution offers a single pane of glass for browsing, requesting, and monitoring your movie and TV show library while keeping a vigilant eye on system health metrics.

How to Use MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery?

Implementation follows a logical three-step process: installation, configuration, and operation. Begin by installing dependencies via pnpm, then set environment variables either through command line exports or a .env file (recommended for organizational clarity). Once configured, choose between local development mode or global deployment using the mcparr CLI for production use. The intuitive API endpoints handle media searches, download requests, and system diagnostics through structured JSON payloads.

MCP Radarr & Sonarr Server Features

Key Features of MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery?

Unified Discovery: Cross-reference movies and series with smart filtering by release year and genre taxonomy
Actionable Intelligence: Initiate downloads directly from search results using ID-based request endpoints
Proactive Monitoring: Real-time status tracking for downloads and automated health checks that include disk utilization analysis
System Awareness: Comprehensive health reports covering component uptime, version compatibility, and storage capacity projections

Use Cases of MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery?

Home theater enthusiasts use this to maintain curated 4K libraries with zero manual intervention. Media managers leverage the API for automated archival processes, while tech-savvy users integrate it into smart home ecosystems via IFTTT triggers. The resource URI schemes (radarr:// and sonarr://) enable frictionless integration with third-party media players and automation frameworks.

MCP Radarr & Sonarr Server FAQ

FAQ from MCP Radarr & Sonarr Server: Streamlined Automation & Seamless Delivery?

What if my API keys aren't working?: Verify both URL endpoints and API keys match your Radarr/Sonarr instance configurations. Check firewall rules and token validity in the respective apps' settings.
Can I monitor multiple servers?: Yes, configure additional .env entries with suffixes like RADARR_URL_2 to register multiple instances.
How do I troubleshoot download failures?: Use the check_status endpoint with media IDs to diagnose queue positioning, indexer availability, and storage constraints.
Is there a web UI?: While headless by default, the API exposes all functionality for custom dashboard development through standard REST calls.

Content

MCP Radarr and Sonarr Server

An MCP server that integrates with Radarr and Sonarr to manage your media library.

Features

Current Features:

Browse your movie and TV show library
Search and filter media by year and genre
Request downloads for movies and TV shows
Check download and monitoring status
System health monitoring and management
- Disk space monitoring
- System health checks
- Status reporting

Installation

Local Installation

Install dependencies:

pnpm install

Global Installation

To install MCParr Server globally on your system:

pnpm run install-global

This will make the mcparr command available globally in your terminal.

Configuration

Set up environment variables:

export RADARR_URL=http://your-radarr-instance:7878
export RADARR_API_KEY=your-radarr-api-key
export SONARR_URL=http://your-sonarr-instance:8989
export SONARR_API_KEY=your-sonarr-api-key

Alternatively, you can create a .env file in your project directory with these variables.

Usage

Running Locally

Build and run the server:

pnpm run build
pnpm start

For development:

pnpm run dev

Running Globally

If installed globally, simply run:

mcparr

API Reference

search_media

Search for movies or TV shows with filters:

{
  mediaType: "movie" | "series",  // Required
  year?: number,                  // Optional
  genre?: string                  // Optional
}

request_download

Request a download for specific media:

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

check_status

Check the status of specific media:

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

get_system_status

Get system health and storage information:

{
  system: "radarr" | "sonarr" | "both"  // Required - Which system to check
}

Response includes:

System status (version, uptime, etc.)
Disk space information
Health check results

Resources

Media is exposed as resources with the following URI schemes:

Movies: radarr://movie/{id}
TV Shows: sonarr://series/{id}

Each resource includes:

Title
Year
Current status