A comprehensive MCP server that provides AI assistants with intelligent access to your entire arr suite media automation stack, including Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, and Plex with natural language processing.

Installation

From PyPI

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 .

Configuration

Claude Desktop

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

Available Tools

Tool	Description
arr_execute	Executes any arr operation using natural language
arr_explain_intent	Understands how your request will be interpreted
arr_list_services	Shows configured services
arr_get_system_status	Gets health status of all services
sonarr_search_series	Search TV series
sonarr_add_series	Adds a new series
sonarr_get_series	Gets all or specific series
radarr_search_movie	Search movies
radarr_add_movie	Adds a new movie
radarr_get_movies	Gets all or specific movies
prowlarr_search	Search by indexers
prowlarr_get_indexers	List all indexers
prowlarr_sync_apps	Sync with applications
plex_search	Search media in Plex
plex_get_libraries	List all libraries

Features

• Intelligent intent recognition using natural language understanding
• Unified interface for all arr services
• Support for Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, and Plex
• Type safety built with Pydantic for robust validation
• Async-first design built on httpx for high-performance operations
• Comprehensive API coverage for all supported services
• Natural language processing for human-like interactions
• Database management utilities for backup and restore
• Queue management and monitoring of all services
• Quality profile and root folder management

Environment Variables

Optional

• SONARR_HOST - Sonarr server hostname
• SONARR_PORT - Sonarr server port
• SONARR_API_KEY - Sonarr API key
• RADARR_HOST - Radarr server hostname
• RADARR_PORT - Radarr server port
• RADARR_API_KEY - Radarr API key
• PROWLARR_HOST - Prowlarr server hostname
• PROWLARR_PORT - Prowlarr server port

Usage Examples

Add Breaking Bad to my collection

Find The Mandalorian

List all my TV shows

Add The Matrix to my movies

Find Inception

Notes

Requires API keys for each service you want to integrate. Supports both high-level natural language commands and service-specific tools. Includes database management utilities and comprehensive API coverage for all supported arr suite services.