arr-mcp

A remote MCP server for managing your arr stack via Claude.ai on mobile. Ask Claude to fix bad downloads, block release groups, request new content, and check what's trending — all from your phone.

Tools (54)

Related MCP server: servarr-mcp

Example workflows

Fix a bad download

"Rick and Morty S09E05 is playing the wrong episode" → finds series → gets episode → checks history → deletes file → blocklists release → searches for replacement

Pick a specific release

"Show me what's available for Severance S02E01" → interactive search → table of releases with quality/size/seeders → grab chosen release

Manage requests

"What requests are pending in Seerr?" → lists pending → "approve the first one" → approved

Add new content

"Add Fallout to Sonarr and search for it" → find series → add with default quality profile → triggers search

Fix stalled downloads after VPN reconnect

"Downloads are stalled" → sync VPN port → qBittorrent updated

Setup

Requirements

• Docker with the arr stack running on arr-net

• Cloudflare Tunnel exposing the service at an HTTPS URL

• Claude Pro/Max/Team plan for remote MCP connectors

Deploy

# 1. Clone
git clone https://github.com/rolim91/arr-mcp ~/Projects/arr-mcp

# 2. Add to ~/Services/arr/docker-compose.yml (see CLAUDE.md for full config)

# 3. Generate auth token
openssl rand -hex 32

# 4. Add to ~/Services/arr/.env
echo "MCP_AUTH_TOKEN=<generated-token>" >> ~/Services/arr/.env

# 5. Build and start
cd ~/Services/arr
docker compose build arr-mcp
docker compose up -d arr-mcp

Connect to Claude.ai

1. claude.ai → Settings → Integrations → Add custom connector

2. URL: https://your-domain.com/mcp

3. Complete the OAuth login with your MCP_AUTH_TOKEN