# MCP Arr (MCP server)

> MCP Arr is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr. It has 222 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-arr-server.

MCP server for the *arr media management suite - Sonarr, Radarr, Lidarr, and Prowlarr. Supports both local stdio mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients such as ChatGPT connectors.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/aplaceforallmystuff/mcp-arr |
| GitHub stars | 222 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: mcp-arr-server |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v1.7.3 (Jul 29, 2026) |
| Last commit | Aug 9, 2026 |
| MCP registry name | io.github.aplaceforallmystuff/mcp-arr |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-arr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "your-value",
        "RADARR_API_KEY": "your-value",
        "LIDARR_API_KEY": "your-value",
        "READARR_API_KEY": "your-value",
        "PROWLARR_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env SONARR_API_KEY=your-value --env RADARR_API_KEY=your-value --env LIDARR_API_KEY=your-value --env READARR_API_KEY=your-value --env PROWLARR_API_KEY=your-value --transport stdio mcp-arr -- npx -y mcp-arr-server
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-arr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "your-value",
        "RADARR_API_KEY": "your-value",
        "LIDARR_API_KEY": "your-value",
        "READARR_API_KEY": "your-value",
        "PROWLARR_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sonarr_api_key",
      "description": "SONARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "radarr_api_key",
      "description": "RADARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "lidarr_api_key",
      "description": "LIDARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "readarr_api_key",
      "description": "READARR_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "prowlarr_api_key",
      "description": "PROWLARR_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "mcp-arr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-arr-server"
      ],
      "env": {
        "SONARR_API_KEY": "${input:sonarr_api_key}",
        "RADARR_API_KEY": "${input:radarr_api_key}",
        "LIDARR_API_KEY": "${input:lidarr_api_key}",
        "READARR_API_KEY": "${input:readarr_api_key}",
        "PROWLARR_API_KEY": "${input:prowlarr_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SONARR_URL`: Sonarr server URL
- `SONARR_API_KEY` (secret): Sonarr API key
- `RADARR_URL`: Radarr server URL
- `RADARR_API_KEY` (secret): Radarr API key
- `LIDARR_URL`: Lidarr server URL
- `LIDARR_API_KEY` (secret): Lidarr API key
- `READARR_URL`: Readarr server URL
- `READARR_API_KEY` (secret): Readarr API key
- `PROWLARR_URL`: Prowlarr server URL
- `PROWLARR_API_KEY` (secret): Prowlarr API key

## Tools

- `arr_status`: Get connection status for all configured *arr services
- `arr_search_all`: Search across all configured services simultaneously
- `search`: Generic discovery tool for remote MCP clients such as ChatGPT
- `fetch`: Generic detail-fetch tool for items returned by search
- `sonarr_get_series`: List all TV series in your library
- `sonarr_search`: Search for TV series by name (returns tvdbId for adding)
- `sonarr_add_series`: Add a TV series to Sonarr (supports tags)
- `sonarr_get_root_folders`: Get available root folders for adding series
- `sonarr_get_quality_profiles`: Get available quality profiles for adding series
- `sonarr_get_queue`: View current download queue with limit and offset pagination
- `sonarr_get_calendar`: See upcoming episodes
- `sonarr_get_episodes`: List episodes for a series (shows missing vs available)
- `sonarr_search_missing`: Trigger search for all missing episodes in a series
- `sonarr_search_episode`: Trigger search for specific episode(s)
- `sonarr_refresh_series`: Trigger a metadata refresh for a specific series in Sonarr
- `radarr_get_movies`: List all movies in your library
- `radarr_search`: Search for movies by name (returns tmdbId for adding)
- `radarr_add_movie`: Add a movie to Radarr (supports tags)
- `radarr_get_root_folders`: Get available root folders for adding movies
- `radarr_get_quality_profiles`: Get available quality profiles for adding movies
- `radarr_get_queue`: View current download queue with limit and offset pagination
- `radarr_get_calendar`: See upcoming releases
- `radarr_search_movie`: Trigger search to download a movie in your library
- `radarr_search_movies`: Bulk-trigger searches for multiple movie IDs at once
- `radarr_update_movie`: Update a movie's quality profile, monitored status, minimum availability, tags, or path
- `radarr_delete_queue_item`: Remove an item from the download queue (optionally blocklist the release)
- `radarr_refresh_movie`: Trigger a metadata refresh for a specific movie in Radarr
- `lidarr_get_artists`: List all artists in your library
- `lidarr_search`: Search for artists by name (returns foreignArtistId for adding)
- `lidarr_add_artist`: Add an artist to Lidarr (supports tags)
- `lidarr_get_root_folders`: Get available root folders for adding artists
- `lidarr_get_quality_profiles`: Get available quality profiles for adding artists
- `lidarr_get_metadata_profiles`: Get available metadata profiles for adding artists
- `lidarr_get_queue`: View current download queue with limit and offset pagination
- `lidarr_get_albums`: List albums for an artist (shows missing vs available)
- `lidarr_search_album`: Trigger search for a specific album
- `lidarr_search_missing`: Trigger search for all missing albums for an artist
- `lidarr_get_calendar`: See upcoming album releases
- `prowlarr_get_indexers`: List all configured indexers
- `prowlarr_search`: Search across all indexers

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/mcp-arr
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
