Log inSubmit server
MCP Arr logo

MCP Arr

Connects Sonarr, Radarr, Lidarr, and Prowlarr to MCP clients for media search and TRaSH Guides configuration reference.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Arr

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-arr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The mcp-arr MCP server connects MCP clients to Sonarr, Radarr, Lidarr, and Prowlarr through local stdio or remote Streamable HTTP. It provides cross-service media search, generic search and fetch tools, service status checks, and TRaSH Guides reference data for profiles, formats, naming, and quality sizes. Configure only the *arr applications you run; without service credentials, it still exposes TRaSH reference tools plus generic search and fetch. Use it when an agent needs to inspect media libraries or review *arr quality and naming settings.

Use cases

  • Search media across configured *arr services
  • Inspect Sonarr, Radarr, Lidarr, and Prowlarr status
  • Review TRaSH Guides quality profiles
  • Compare configured naming and quality settings
  • Retrieve structured details for discovered media

Key features

  • Cross-service *arr media search
  • Generic search and fetch tools
  • TRaSH Guides quality profile references
  • Custom format and quality-size lookup
  • Naming convention recommendations
  • Stdio and Streamable HTTP transports

Tools11

What MCP Arr lets your agent do. Expand a tool for its parameters.

Verified live~925 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

25/29 checks healthy over the last 90d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · mcp-arr-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars238Stargazers on the source repository.
npm downloads4.4kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Arr works

What mcp-arr does

The mcp-arr MCP server exposes media-management operations from the *arr ecosystem through the Model Context Protocol. It supports Sonarr for television, Radarr for movies, Lidarr for music, and Prowlarr for indexer management when those services are configured with their URLs and API keys.

The server includes two kinds of functionality. Service-connected tools can inspect configured applications and search their libraries. TRaSH Guides tools provide reference information even when no local *arr service is available. This makes the server useful both for managing an existing media setup and for researching quality or naming standards before configuring one.

How it works

The mcp-arr MCP server can run locally over stdio or remotely over Streamable HTTP. Local execution is suitable for clients such as Claude Desktop and Claude Code, while HTTP mode provides an /mcp endpoint for hosted MCP clients such as ChatGPT connectors.

The generic search tool discovers matching media and TRaSH profiles, and fetch retrieves structured details for an opaque result identifier returned by search. arr_search_all searches across configured *arr services. arr_status reports the status of supported services; when none are configured, TRaSH reference tools remain available.

Service availability is determined from the environment variables supplied at startup. The server does not require every supported application to be installed or configured.

Setup and configuration

The package can be started with npx mcp-arr-server, built from source with npm, or run from a published GitHub Container Registry image. Node.js 18 or newer is listed as a prerequisite for the npm installation path.

For each application, obtain its API key from the application’s Settings, General, and Security areas. Set the matching URL and API-key variables only for services that are running. The documented service variables cover Sonarr, Radarr, Lidarr, and Prowlarr.

Remote mode is enabled with MCP_TRANSPORT=http. HOST, PORT, and MCP_PATH can change the bind address, listening port, and MCP endpoint path; defaults are 127.0.0.1, 3000, and /mcp. In Docker, HTTP mode requires publishing the selected port and setting a reachable bind host such as 0.0.0.0.

Tools and capabilities

The mcp-arr MCP server provides the following documented tools:

  • arr_status checks supported service status.
  • arr_search_all searches all configured *arr services.
  • search and fetch support generic remote-client discovery and retrieval.
  • trash_list_profiles and trash_get_profile expose TRaSH quality profiles.
  • trash_list_custom_formats lists formats with category filters such as HDR, audio, resolution, source, streaming, anime, unwanted, release, and language.
  • trash_get_naming returns recommended naming conventions for Plex, Emby, Jellyfin, or standard setups.
  • trash_get_quality_sizes returns recommended size ranges by quality level.
  • trash_compare_profile and trash_compare_naming compare configured *arr settings with TRaSH recommendations when the relevant service is configured.

Limitations and notes

Profile and naming comparisons require the corresponding *arr service to be configured. If no services are configured, the server still starts, but service-specific library operations cannot inspect local applications. The material documents TRaSH reference access in that mode, along with the generic search and fetch tools.

Client connectivity also depends on making a remote HTTP endpoint reachable when using hosted clients.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Arr

mcp-arr is an MCP server that connects AI clients to Sonarr, Radarr, Lidarr, and Prowlarr. Its main tools search configured media services, report service status, retrieve search results, and expose TRaSH Guides profiles, custom formats, naming recommendations, quality sizes, and configuration comparisons.

Install it with `npx mcp-arr-server`, or run the published container image from GitHub Container Registry. From source, clone the repository, run `npm install`, and then `npm run build`. Node.js 18 or newer is listed as a prerequisite for the npm path.

Set the service URL and API key environment variables for each application you want to use, such as `SONARR_URL` and `SONARR_API_KEY` or the corresponding Radarr variables. The server detects configured services automatically, so unused applications can be omitted.

Yes, mcp-arr starts without configured *arr services and keeps its TRaSH Guides reference tools available. Generic `search` and `fetch` also remain available, but service-specific library searches and comparisons that require a configured application cannot inspect local data.

Run mcp-arr in remote HTTP mode and connect ChatGPT to its `/mcp` endpoint. Set `MCP_TRANSPORT=http`; the default bind address is `127.0.0.1`, the default port is `3000`, and the generic `search` and `fetch` tools support ChatGPT-style remote MCP integrations.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Arr AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-arr?style=directory)](https://allmcps.com/mcp/mcp-arr)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-arr"><img src="https://allmcps.com/api/badge/mcp-arr?style=directory" alt="MCP Arr on AllMCPs" /></a>