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.1Add to claude_desktop_config.json
{
"mcpServers": {
"arr-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/bardesss/arr-mcp:2.2.1"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"arr-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/bardesss/arr-mcp:2.2.1"
]
}
}
}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 /configPGIDGroup id owning the files in /configTZTimezone 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

MaineMCP
MCP serverSearch public Maine events, communities and startups, with links to the source listings
- 4 tools
- Remote
- Free
- Events and entertainment

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory
Agent Bookability Index
MCP serverNYC-area event vendor prices, areas and booking options sourced from vendor sites
- 9 tools
- Remote
- Free
- Events and entertainment
Tap2Cal
MCP serverCreate shareable add-to-calendar links and read RSVPs from your AI assistant
Not checked yet- 9 tools
- Remote
- Free
- Productivity

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents