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

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.

• 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)

• 🧠 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

pip install arr-suite-mcp

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

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

arr-suite-mcp

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" } } } }

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

"Add Breaking Bad to my collection" "Search for The Mandalorian" "List all my TV shows" "Get episodes for Game of Thrones season 8" "Monitor The Office for new episodes" 

"Add The Matrix to my movies" "Search for Inception" "Show all my 4K movies" "Get details for The Godfather" "Find movies from 2023" 

"Search for Dune across all indexers" "List all my indexers" "Test all indexers" "Sync indexers to Radarr and Sonarr" "Show indexer statistics" 

"Download English subtitles for Dune" "Search for Spanish subtitles for episode 3" "Show movies missing subtitles" "Get subtitle providers" 

"Request Avatar 2" "Show pending requests" "Approve request 123" "Search for trending movies" "Discover new TV shows" 

"Search Plex for Breaking Bad" "Show my Plex libraries" "What's recently added to Plex?" "Show what's playing on Plex" "Get On Deck items" "Scan my Movies library" "Mark The Matrix as watched" 

"Backup all Sonarr databases" "Update quality profile in Radarr" "Configure download client in Prowlarr" "Get system status for all services" 

The server provides both high-level intelligent tools and service-specific tools:

• arr_execute - Execute any arr operation using natural language
• arr_explain_intent - Understand how your query will be interpreted
• arr_list_services - Show configured services
• arr_get_system_status - Get health status of all services

Each service has dedicated tools for precise control:

• sonarr_search_series - Search for TV series
• sonarr_add_series - Add a new series
• sonarr_get_series - Get all or specific series
• And 20+ more operations

• radarr_search_movie - Search for movies
• radarr_add_movie - Add a new movie
• radarr_get_movies - Get all or specific movies
• And 20+ more operations

• prowlarr_search - Search across indexers
• prowlarr_get_indexers - List all indexers
• prowlarr_sync_apps - Sync to applications
• And 15+ more operations

• plex_search - Search Plex media
• plex_get_libraries - List all libraries
• plex_get_recently_added - Recently added content
• plex_get_sessions - Currently playing
• plex_scan_library - Scan library for new content
• plex_mark_watched - Mark as watched
• And more...

The server uses environment variables with prefixes for each service:

# Format: {SERVICE}_{SETTING} SONARR_HOST=localhost SONARR_PORT=8989 SONARR_API_KEY=abc123 SONARR_SSL=false # Global Settings REQUEST_TIMEOUT=30 MAX_RETRIES=3 LOG_LEVEL=INFO

1. Open the web UI
2. Settings → General
3. Security section → API Key

1. Open the web UI
2. Settings → General
3. Security section → API Key

1. Open the web UI
2. Settings → General
3. Security section → API Key

1. Open the web UI
2. Settings → General
3. API Key section

┌─────────────────────────────────────────┐ │ AI Assistant (Claude) │ └────────────────┬────────────────────────┘ │ MCP Protocol ┌────────────────▼────────────────────────┐ │ Arr Suite MCP Server │ │ ┌─────────────────────────────────┐ │ │ │ Intent Router (NLP) │ │ │ │ - Analyzes natural language │ │ │ │ - Determines service & action │ │ │ └─────────────┬───────────────────┘ │ │ │ │ │ ┌─────────────▼───────────────────┐ │ │ │ Service Clients │ │ │ │ ┌──────────┐ ┌──────────┐ │ │ │ │ │ Sonarr │ │ Radarr │ │ │ │ │ ├──────────┤ ├──────────┤ │ │ │ │ │ Prowlarr │ │ Bazarr │ │ │ │ │ ├──────────┤ ├──────────┤ │ │ │ │ │Overseerr │ │ More... │ │ │ │ │ └──────────┘ └──────────┘ │ │ │ └─────────────────────────────────┘ │ └────────────────┬────────────────────────┘ │ HTTP/REST APIs ┌────────────────▼────────────────────────┐ │ Your Arr Stack Services │ │ Sonarr│Radarr│Prowlarr│Bazarr│etc. │ └─────────────────────────────────────────┘ 

The server includes utilities for managing arr suite databases:

from arr_suite_mcp.utils.db_manager import ArrDatabaseManager # Backup all databases manager = ArrDatabaseManager(config_path="/path/to/arr/configs") await manager.backup_all() # Restore a database await manager.restore("sonarr", "/path/to/backup.db") # Execute SQL query result = await manager.execute_query("sonarr", "SELECT * FROM Series")

# Install dev dependencies pip install -e ".[dev]" # Run tests pytest # Run with coverage pytest --cov=arr_suite_mcp --cov-report=html

# Format code black arr_suite_mcp # Lint ruff check arr_suite_mcp # Type check mypy arr_suite_mcp

✅ Series Management (add, update, delete, search) ✅ Episode Management ✅ Quality Profiles ✅ Root Folders ✅ Tags ✅ Queue Management ✅ History ✅ Calendar ✅ Commands (refresh, rescan, rename, backup) ✅ Configuration

✅ Movie Management (add, update, delete, search) ✅ Collections ✅ Quality Profiles ✅ Root Folders ✅ Tags ✅ Queue Management ✅ History ✅ Calendar ✅ Commands (refresh, rescan, rename, backup) ✅ Configuration ✅ Import Lists ✅ Notifications

✅ Indexer Management (add, update, delete, test) ✅ Search across Indexers ✅ Application Management (Sonarr, Radarr connections) ✅ Tags ✅ History ✅ Statistics ✅ Download Clients ✅ Notifications ✅ Configuration ✅ Sync Operations

✅ Series Subtitle Management ✅ Movie Subtitle Management ✅ Subtitle Search ✅ Subtitle Download ✅ History ✅ Languages ✅ Providers ✅ System Status ✅ Settings ✅ Wanted Subtitles ✅ Blacklist

✅ Request Management (create, approve, decline) ✅ Media Search ✅ Discovery (movies, TV) ✅ Trending Content ✅ User Management ✅ Settings (Plex, Radarr, Sonarr) ✅ System Status ✅ Issues

# Test connectivity curl http://localhost:8989/api/v3/system/status?apikey=YOUR_API_KEY # Check logs arr-suite-mcp --log-level DEBUG

1. API Key Invalid: Double-check your API keys in the web UI
2. Connection Refused: Ensure services are running and accessible
3. SSL Errors: Set {SERVICE}_SSL=false for local deployments

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

MIT License - see LICENSE for details.

• Built with MCP by Anthropic
• Powered by the amazing arr suite projects
• Inspired by the home media automation community

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

• Jackett full integration
• Lidarr support (music)
• Readarr support (books)
• Whisparr support (adult content)
• Advanced filtering and sorting
• Batch operations
• Custom scripts integration
• WebSocket support for real-time updates
• Metrics and monitoring
• Multi-instance support

Made with ❤️ for the media automation community