arr-suite

MCP Server for Plex + the *arr suite of media server tools

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio shaktech786-arr-suite-mcp-server python -m arr_suite_mcp \
  --env LOG_LEVEL="INFO" \
  --env BAZARR_HOST="localhost" \
  --env BAZARR_PORT="6767" \
  --env MAX_RETRIES="3" \
  --env RADARR_HOST="localhost" \
  --env RADARR_PORT="7878" \
  --env SONARR_HOST="localhost" \
  --env SONARR_PORT="8989" \
  --env PROWLARR_HOST="localhost" \
  --env PROWLARR_PORT="9696" \
  --env BAZARR_API_KEY="your_bazarr_api_key" \
  --env OVERSEERR_HOST="localhost" \
  --env OVERSEERR_PORT="5055" \
  --env RADARR_API_KEY="your_radarr_api_key" \
  --env SONARR_API_KEY="your_sonarr_api_key" \
  --env REQUEST_TIMEOUT="30" \
  --env PROWLARR_API_KEY="your_prowlarr_api_key" \
  --env OVERSEERR_API_KEY="your_overseerr_api_key"

How to use

Arr Suite MCP Server provides a unified, NLP-driven interface to manage your Arr stack (Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, Plex, and more). It routes natural language requests to the appropriate service, exposing a single API for all configured services and supporting high-performance async operations. You can ask it to search, add, or manage items across Sonarr and Radarr, browse indexers with Prowlarr, handle subtitles with Bazarr, manage requests via Overseerr, and interact with Plex. The server exposes intelligent tools like arr_execute, arr_explain_intent, arr_list_services, and arr_get_system_status, along with service-specific tools (e.g., sonarr_add_series, radarr_add_movie, prowlarr_search, plex_scan_library). To use it, run the MCP server, ensure your environment variables point to your local Arr services, and then issue natural language commands through your MCP client (e.g., Claude) to perform tasks across the Arr suite.

How to install

Prerequisites:

Python 3.10 or newer
pip (Python package installer)

Option A: Install from PyPI (recommended)

Install the MCP server: pip install arr-suite-mcp
Run the server: arr-suite-mcp

Option B: Install from Source

Clone the repository: git clone https://github.com/shaktech786/arr-suite-mcp-server.git
Navigate to the project folder: cd arr-suite-mcp-server
Install in editable mode: pip install -e .
Run the server: arr-suite-mcp

Notes:

If you prefer using pipx for isolation, you can install via: pipx install arr-suite-mcp (or pipx run arr-suite-mcp)
Ensure your environment is configured with the required service credentials (see .env example in the repository).

Additional notes

Environment variables should be set per service (Sonarr, Radarr, Prowlarr, Bazarr, Overseerr) and any global MCP settings. Common issues include network connectivity to the Arr services, incorrect API keys, or mismatched ports. If the server cannot reach a service, verify the service is running, the host/port in your .env file are correct, and the API key has the necessary permissions. For Claude Desktop integration, ensure the arr-suite entry uses the correct command and environment in claude_desktop_config.json. If you upgrade the MCP server, review breaking changes in the release notes and validate that all service integrations continue to work with updated APIs.

Related MCP Servers

web-eval-agent

1.2k

An MCP server that autonomously evaluates web applications.

mcp-neo4j

911

Neo4j Labs Model Context Protocol servers

Gitingest

136

mcp server for gitingest

fhir

FHIR MCP Server – helping you expose any FHIR Server or API as a MCP Server.

unitree-go2

The Unitree Go2 MCP Server is a server built on the MCP that enables users to control the Unitree Go2 robot using natural language commands interpreted by a LLM.

sympy

A MCP server for symbolic manipulation of mathematical expressions