Skip to content

Installation

arr-mcp is a standard Python package and a prebuilt container image. Pick the path that matches how the operator want to run it.

Requirements

  • Python 3.11 – 3.14.
  • One or more reachable Arr Suite services (Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, Seerr, Chaptarr) — see Backing Platform to provision them locally.
pip install arr-mcp

Optional extras

The base install is intentionally minimal. Install the extra for what the operator need:

Extra Install Pulls in
mcp pip install "arr-mcp[mcp]" FastMCP MCP-server runtime (scion-sdk)
all pip install "arr-mcp[all]" Everything above
test pip install "arr-mcp[test]" The pytest suite (pytest, pytest-xdist, pytest-asyncio)

From source

git clone https://github.com/Knuckles-Team/arr-mcp.git
cd arr-mcp
pip install -e ".[all]"          # editable install with every extra

With uv:

uv pip install -e ".[all]"
uv run arr-mcp

Prebuilt Docker image

A multi-stage runtime image is published on every release (entrypoint arr-mcp):

docker pull example/arr-mcp@sha256:<digest>

docker run --rm -i \
  -e SONARR_BASE_URL=http://your-sonarr:8989 \
  -e SONARR_TOKEN=your_sonarr_api_key \
  example/arr-mcp@sha256:<digest>            # stdio transport (default)

Deployment.

Verify the install

arr-mcp --help
python -c "import arr_mcp; print(arr_mcp.__version__)"

Next steps

  • Usage — call the tools, the API clients, and the CLI.
  • Configuration — every environment variable.