Arr Suite MCP Server

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with intelligent access to your entire arr suite media automation stack.

Overview

The Arr Suite MCP Server is a powerful integration that connects AI assistants like Claude to your media automation infrastructure. It uses intelligent natural language processing to automatically route requests to the appropriate service, making media management feel natural and intuitive.

Supported Services

• Sonarr - TV Series management
• Radarr - Movie management
• Prowlarr - Indexer management and search
• Bazarr - Subtitle management
• Overseerr - Media request and discovery
• Plex - Media Server management and playback
• Jackett - Alternative indexer proxy (coming soon)

Key Features

• 🧠 Intelligent Intent Recognition: Uses natural language understanding to automatically determine which service to use
• 🎯 Unified Interface: Single API for all arr services
• 🔌 Easy Integration: Simple environment variable configuration
• 🛡️ Type-Safe: Built with Pydantic for robust validation
• ⚡ Async-First: Built on httpx for high-performance async operations
• 📝 Comprehensive: Full API coverage for all supported services
• 🎨 Natural Language: Talk to your media server like a human

Installation

From PyPI (recommended)

pip install arr-suite-mcp

From Source

git clone https://github.com/shaktech786/arr-suite-mcp-server.git
cd arr-suite-mcp-server
pip install -e .

Quick Start

1. Configure Environment

Create a .env file:

# Sonarr Configuration
SONARR_HOST=localhost
SONARR_PORT=8989
SONARR_API_KEY=your_sonarr_api_key

# Radarr Configuration
RADARR_HOST=localhost
RADARR_PORT=7878
RADARR_API_KEY=your_radarr_api_key

# Prowlarr Configuration
PROWLARR_HOST=localhost
PROWLARR_PORT=9696
PROWLARR_API_KEY=your_prowlarr_api_key

# Bazarr Configuration
BAZARR_HOST=localhost
BAZARR_PORT=6767
BAZARR_API_KEY=your_bazarr_api_key

# Overseerr Configuration
OVERSEERR_HOST=localhost
OVERSEERR_PORT=5055
OVERSEERR_API_KEY=your_overseerr_api_key

2. Run the Server

arr-suite-mcp

3. Configure Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "arr-suite": {
      "command": "arr-suite-mcp",
      "env": {
        "SONARR_HOST": "localhost",
        "SONARR_PORT": "8989",
        "SONARR_API_KEY": "your_api_key"
      }
    }
  }
}

Usage Examples

The beauty of this MCP server is its natural language understanding. Here are some examples:

TV Shows (Sonarr)

"Add Breaking Bad to my collection"