Skip to content
MCP server

arr-mcp

One self-hosted MCP server for Radarr, Sonarr, Jellyfin, Plex, Seerr and downloaders

Pricing
Open source
Platforms
self-hosted, API, CLI
Runs
Remotely
Version
2.2.1
Listing updated
2 days ago

About arr-mcp

arr-mcp is an open-source MCP server for events and entertainment. It runs as a hosted remote server, so there is nothing to install locally.

The idea behind arr-mcp is that the useful questions about a home media setup sit between services. Its headline tool, diagnose_media, follows a title through request, monitoring, download, indexing, import and library scan, and names the first step that explains why it is missing. It still answers when one service is down and says which part it could not check.

It runs as a container (images for amd64 and arm64, plus an Unraid template and a Proxmox LXC script). A browser config page, claimed with a username and password on first visit, is where you add each service's URL and key; your MCP client then connects to /mcp with a token. Writes are off until you enable them per service, each one is previewed and needs confirmation, and all of them land in an audit trail.

Release names from public indexers are treated as untrusted data and fenced before they reach the model. An optional library event log keeps history after a title is deleted, and quality-profile checks flag settings that cannot do what they say, including profiles synced from TRaSH Guides through Profilarr.

Install

Run in a terminal

claude mcp add arr-mcp -- docker run -i --rm ghcr.io/bardesss/arr-mcp:2.2.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "arr-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}

Configuration

  • PUIDUser id owning the files in /config
  • PGIDGroup id owning the files in /config
  • TZTimezone used for timestamps, e.g. Europe/Amsterdam

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

diagnose_media
Walk the request-to-library chain for a title and name the first thing that explains its absence.
get_history
Return what the stack and the library event log recorded about a title.

What it does

Cross-service diagnosis
diagnose_media correlates requests, indexers, downloads and the media server to explain a missing title.
Covers the whole stack
Works with Radarr, Sonarr, Lidarr, Prowlarr, Bazarr, Jellyfin, Plex, Seerr, SABnzbd, qBittorrent and more.
Opt-in writes
Writes are off by default, previewed, confirmed and recorded in an audit trail.
Indexer text fencing
Release names from public indexers are fenced so they are treated as data, not instructions.
Library event log
Optionally keeps history that Radarr, Sonarr and Lidarr would lose when a title is deleted.
Browser config page
Add services, see what is broken and read logs without editing YAML.
Flexible auth
Per-token tiers and expiry, with optional OAuth 2.1 access tokens if you run an identity provider.

Good for

  • Find out why a requested film never appeared in Jellyfin
  • Check what is downloading and whether anything is stuck
  • Spot indexers that are failing and read their errors
  • Audit quality profiles for scores nothing can reach
  • Ask for missing subtitles or a different release by chat

Pricing

Open source

Self-hosted container; no price listed

arr-mcp FAQ

How do I run it?

As a Docker container (ghcr.io/bardesss/arr-mcp), an Unraid template or a Proxmox LXC script. Open port 6060, claim the instance with a password of at least 12 characters, then add your services.

Can the AI delete or change things?

Only if you turn writes on for a service. Each write shows what it would do, waits for confirmation and is logged.

Does it work over stdio?

Yes, with --stdio, but that connection is read-only; writes need the HTTP endpoint and a token.

Where do my API keys live?

In config.yaml under /config. The README warns to claim the instance before exposing the port because it holds every service's keys.

Is arr-mcp free?

Yes. arr-mcp is open source, so you can use and self-host it for free.

How do I add arr-mcp to Claude Code?

Run this command in your terminal: claude mcp add arr-mcp -- docker run -i --rm ghcr.io/bardesss/arr-mcp:2.2.1

What are the best alternatives to arr-mcp?

The closest alternatives to arr-mcp are MaineMCP, Agent Yurt, Agent Bookability Index, Tap2Cal and Proofline.

Alternatives to arr-mcp

  1. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment
  2. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  3. NYC-area event vendor prices, areas and booking options sourced from vendor sites

    • 9 tools
    • Remote
    • Free
    • Events and entertainment
  4. Tap2Cal

    MCP server

    Create shareable add-to-calendar links and read RSVPs from your AI assistant

    Not checked yet
    • 9 tools
    • Remote
    • Free
    • Productivity
  5. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  6. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents