MCP *arr Server

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)

npx mcp-arr-server

From Source

git clone https://github.com/aplaceforallmystuff/mcp-arr.git
cd mcp-arr
npm install
npm run build

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.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "LIDARR_URL": "http://localhost:8686",
        "LIDARR_API_KEY": "your-lidarr-api-key",
        "READARR_URL": "http://localhost:8787",
        "READARR_API_KEY": "your-readarr-api-key",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your-prowlarr-api-key"
      }
    }
  }
}

For Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key"
      }
    }
  }
}

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

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
SONARR_URL="http://localhost:8989" SONARR_API_KEY="your-key" node dist/index.js

Troubleshooting

"No *arr services configured"

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

SONARR_URL="http://localhost:8989"
SONARR_API_KEY="your-api-key"

"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