Arr Suite
- python
0
GitHub Stars
python
Language
7 months ago
First Indexed
3 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"shaktech786-arr-suite-mcp-server": {
"command": "arr-suite-mcp",
"args": [],
"env": {
"BAZARR_HOST": "localhost",
"BAZARR_PORT": "6767",
"RADARR_HOST": "localhost",
"RADARR_PORT": "7878",
"SONARR_HOST": "localhost",
"SONARR_PORT": "8989",
"PROWLARR_HOST": "localhost",
"PROWLARR_PORT": "9696",
"BAZARR_API_KEY": "your_bazarr_api_key",
"OVERSEERR_HOST": "localhost",
"OVERSEERR_PORT": "5055",
"RADARR_API_KEY": "your_api_key",
"SONARR_API_KEY": "your_api_key",
"PROWLARR_API_KEY": "your_prowlarr_api_key",
"OVERSEERR_API_KEY": "your_overseerr_api_key"
}
}
}
}You can run Arr Suite MCP Server locally to give AI assistants intelligent, unified access to all your Arr stack services. It routes natural language requests to Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, Plex, and more, so you can manage your media with plain language and a single API surface.
How to use
Interact with the MCP server using an MCP client. Start the server locally and point your client at the provided MCP entry point. You’ll speak in natural language, and the server’s intent router will map your requests to the appropriate Arr service. You can ask to add TV shows, search for movies, manage indexers, fetch subtitles, handle media requests, or query Plex — all through a single, unified interface.
How to install
Prerequisites you need before installation are Python and a working internet connection.
pip install arr-suite-mcp
# Or install from source
git clone https://github.com/shaktech786/arr-suite-mcp-server.git
cd arr-suite-mcp-server
pip install -e .
Configuration and usage notes
Configure environment variables for each connected service. You typically provide host, port, and API key values for Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, and similar tools. You can also set global options like request timeout and log level. When running the server, you’ll point your MCP client to the runtime process and, if you use Claude Desktop, supply a configuration snippet that includes the running command and environment variables.
Troubleshooting and tips
If you encounter connectivity issues, verify that each underlying service is running and reachable at its configured host/port. Check the MCP server logs for startup messages and any validation errors. If you see SSL-related errors during local development, set SSL to false for the services you’re testing.
Advanced usage tips
Use the Intelligent Tools to understand how your natural language query will be interpreted and to discover the available operations. You can list configured services, check system health, and execute precise operations against specific Arr services.
Available tools
arr_execute
Execute any arr operation using natural language and return the result from the underlying service.
arr_explain_intent
Explain how your natural language query will be interpreted by the MCP server.
arr_list_services
Show the configured Arr services that MCP can interact with.
arr_get_system_status
Retrieve health and status information for all connected services.
sonarr_search_series
Search for TV series in Sonarr.
sonarr_add_series
Add a new TV series to Sonarr.
sonarr_get_series
Get all series or a specific series from Sonarr.
radarr_search_movie
Search for movies in Radarr.
radarr_add_movie
Add a new movie to Radarr.
radarr_get_movies
Get all movies or a specific movie from Radarr.
prowlarr_search
Search across indexers via Prowlarr.
prowlarr_get_indexers
List all indexers managed by Prowlarr.
prowlarr_sync_apps
Sync applications between Prowlarr and other services.
plex_search
Search Plex libraries and media.
plex_get_libraries
List Plex libraries.
plex_get_recently_added
Fetch recently added content from Plex.
plex_get_sessions
Show currently playing media in Plex.
