# arr-mcp

Connects *arr services, Jellyfin, Plex, Seerr and download clients through MCP. Trace where a media request stalled before it reached Jellyfin.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 84
- Author: bardesss
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bardesss/arr-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/arr-mcp

## What it does

arr-mcp brings media services together through 39 tools. Its `diagnose` tool follows a request from its origin to Jellyfin and identifies the stage where progress stopped. The server also checks Profilarr quality profiles and describes settings that need adjustment.

Add services in the configuration page with their URL and API key. Plex uses `X-Plex-Token`; Transmission and qBittorrent require a username and password. Write operations are disabled until enabled per service, preview the proposed change and wait for confirmation. Set the account credentials before exposing the port: the first visitor to the setup page claims the instance, which holds service API keys.

For Docker, the repository includes `docker-compose.example.yml`. Once the server is running, point the MCP client at `http://<host>:6060/mcp` and create a token in the configuration page. The token appears once, so copy it into the client immediately. Short-lived OAuth 2.1 tokens are also accepted when an identity provider is already in use.

## Requirements
- Needs: Docker
- Environment variables: `PUID`, `PGID`, `TZ` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- trace why a requested film never appeared in Jellyfin
- check the request path across Seerr, Radarr and Jellyfin
- find a quality-profile setting Profilarr cannot satisfy
- preview the changes a write operation would make

## Example prompts
- Find where the request for this film stopped before it reached Jellyfin.
- Trace the request for “Blade” and report the first blocked stage.
- Check this Profilarr quality profile and suggest the setting to change.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md