arr-mcp

FastMCP 3.4 MCP server for the complete *arr automation stack — Radarr, Sonarr, Lidarr, Prowlarr, Readarr, Overseerr, and Bazarr — under a single MCP interface.

New here? Start at docs/ONBOARDING.md (10-minute setup, no account needed).

Install (Claude Desktop)

Download arr-mcp.mcpb + install.ps1 from the latest release, then run install.ps1 — it installs the bundle into Claude Desktop. Other MCP clients (Cursor, Windsurf, opencode):

{
  "mcpServers": {
    "arr-mcp": { "command": "uvx", "args": ["arr-mcp"] }
  }
}

Features

• 7 services, 1 MCP server — Radarr (Movies), Sonarr (TV), Lidarr (Music), Prowlarr (Indexers), Readarr (Books), Overseerr (Requests), Bazarr (Subtitles)
• 31 MCP tools — portmanteau tools + single-purpose tools + 3 Prefab card tools
• Cross-arr orchestration — request a title, auto-routes to correct arr with Jellyfin availability check
• Prefab-UI cards — arr_health_card, arr_calendar_card, arr_stats_card (@mcp.tool(app=True)) — rich interactive cards in Claude Desktop, Cursor
• Prowlarr indexer backbone — unified search across all indexers
• Auto-discovery — probes default ports for running *arr services; no config needed for standard setups
• Settings → Services — paste URL + API key per service in the webapp, Test, Save: live immediately, no .env, no restart (.env still works as fallback)
• FastMCP 3.3 resources — arr://config, arr://quickstart, arr://help, arr://capabilities for agent self-discovery
• LLM sampling — arr_agentic tool with Context injection for LLM-powered cross-arr workflows
• React dashboard — 15-page webapp with health monitoring, LLM chat, MCP Inspector, live SSE log streaming
• Local LLM chat — built-in chat page with Ollama and LM Studio model selection (backend-proxied: keys never leave the server)