MCP *arr Server

MCP server for the *arr media management suite - Sonarr, Radarr, Lidarr, Readarr, and Prowlarr.

Why Use This?

• Unified media management - Control all your *arr applications from one interface

• Natural language queries - Ask about your library in plain English

• Cross-service search - Find content across TV, movies, music, and books simultaneously

• Download monitoring - Check queue status and progress across all services

• Calendar integration - See upcoming releases for all media types

• Flexible configuration - Enable only the services you use

Features

Prerequisites

• Node.js 18+

• At least one *arr application running with API access:

  • Sonarr for TV series

  • Radarr for movies

  • Lidarr for music

  • Readarr for books

  • Prowlarr for indexer management

Installation

Using npm (Recommended)

From Source

Configuration

Getting API Keys

Each *arr application has an API key in Settings > General > Security:

1. Open your *arr application's web interface

2. Go to Settings > General

3. Find the API Key under the Security section

4. Copy the API key for use in configuration

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

For Claude Code

Add to ~/.claude.json:

Note: Only configure the services you have running. The server automatically detects which services are available based on the environment variables you provide.

Usage Examples

Library Management

• "Show me all my TV series"

• "What movies do I have in Radarr?"

• "List all artists in my music library"

• "How many books do I have by Stephen King?"

Searching for Content

• "Search for Breaking Bad on Sonarr"

• "Find the movie Inception"

• "Search for Taylor Swift albums"

• "Look up books by Brandon Sanderson"

Download Queue

• "What's downloading right now?"

• "Check the Sonarr queue"

• "Show Radarr download progress"

Upcoming Releases

• "What TV episodes are coming this week?"

• "Show upcoming movie releases"

• "Any new albums coming out this month?"

• "Show me upcoming book releases"

Downloading Content

• "What episodes of Severance am I missing?"

• "Download the missing episodes for that show"

• "Search for this specific movie"

• "Grab that Japanese Breakfast album"

• "Download all missing books by Brandon Sanderson"

Indexer Management

• "Are my indexers healthy?"

• "How are my indexers performing?"

• "Test all my Prowlarr indexers"

Cross-Service

• "Check status of all my *arr services"

• "Search for 'The Office' across all services"

Available Tools

General Tools

Sonarr Tools (TV)

Radarr Tools (Movies)

Lidarr Tools (Music)

Readarr Tools (Books)

Prowlarr Tools (Indexers)

Development

Troubleshooting

"No *arr services configured"

Ensure you have set at least one pair of URL and API_KEY environment variables:

"API error: 401 Unauthorized"

The API key is incorrect. Verify it in your *arr application under Settings > General > Security.

"fetch failed" or "ECONNREFUSED"

The *arr application is not running or the URL is incorrect. Verify:

• The application is running

• The URL and port are correct

• There's no firewall blocking the connection

"Sonarr/Radarr/etc not configured"

You tried to use a tool for a service that isn't configured. Add the corresponding URL and API_KEY environment variables.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE for details.

Links

• Servarr Wiki - Documentation for all *arr applications

• Sonarr API Docs

• Model Context Protocol

• GitHub Repository