radarr-mcp

MCP搜索检索

提供方 cvalerio

搜索检索 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaude
查看接入方式

RadarrMCP is an MCP server that exposes Radarr's movie management capabilities as MCP tools, allowing users to search, add, monitor, and manage movies via natural language in MCP clients like Claude.

一句话选型结论

按资料字段整理

radarr-mcp 属于搜索检索类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment Movie Management MCP Server C# Natural Language Interface Media Automation Radarr Integration

支持客户端

适用场景

Local DeploymentMovie ManagementMCP Server

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
/path/to/RadarrMcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
radarr-mcp当前 未标注 stdio · 本地进程 本地部署 有 2026-09-18
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cvalerio上游标注的维护方 cvalerio
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-09-18上游最后核验时间

详细介绍

15.5 KB
来自项目仓库与上游目录的原文,未做删改

RadarrMCP

A production-grade Model Context Protocol (MCP) server for Radarr v3, built with .NET 10.

Expose your Radarr instance as MCP tools so Claude (or any MCP client) can search, add, monitor, and manage movies via natural language.


Prerequisites

  • .NET 10 SDK
  • A running Radarr v3 instance
  • A Radarr API key (Settings → General → Security)

Build```bash

Debug build

dotnet build

Self-contained single binary for Linux x64

dotnet publish -c Release -r linux-x64 --self-contained

Self-contained single binary for Windows x64

dotnet publish -c Release -r win-x64 --self-contained

Self-contained single binary for macOS arm64 (Apple Silicon)

dotnet publish -c Release -r osx-arm64 --self-contained


Output lands in `bin/Release/net10.0//publish/`.

---

## Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `RADARR__URL` | yes | — | Base URL of your Radarr instance, e.g. `http://radarr:7878` |
| `RADARR__APIKEY` | yes | — | API key from Radarr → Settings → General → Security |
| `RADARR__TIMEOUTMS` | no | `15000` | Per-request timeout in milliseconds |
| `RADARR__MOVETIMEOUTMS` | no | `120000` | Timeout in milliseconds for the `radarr_move_movies` request (no retries) |

> **Note:** `__` (double underscore) is the .NET hierarchy separator. Property names are matched case-insensitively with no underscore substitution — `RADARR__APIKEY` maps to `ApiKey`, not `RADARR__API_KEY`.

---

## Claude Desktop Configuration

Add to `claude_desktop_config.json`:```json
{
  "mcpServers": {
    "radarr": {
      "command": "/path/to/RadarrMcp",
      "env": {
        "RADARR__URL": "http://radarr:7878",
        "RADARR__APIKEY": "your-api-key-here"
      }
    }
  }
}

On Windows use the .exe binary and forward slashes or escaped backslashes.


Claude Code Configuration```bash

claude mcp add radarr /path/to/RadarrMcp \
-e RADARR__URL=http://radarr:7878 \
-e RADARR__APIKEY=your-api-key-here


---

## Docker Compose

Deploy alongside an existing Radarr stack:```yaml
services:
  radarr:
    image: lscr.io/linuxserver/radarr:latest
    container_name: radarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - /config/radarr:/config
      - /data/movies:/movies
      - /data/downloads:/downloads
    ports:
      - 7878:7878
    restart: unless-stopped

  radarr-mcp:
    image: mcr.microsoft.com/dotnet/runtime-deps:10.0
    container_name: radarr-mcp
    command: /app/RadarrMcp
    volumes:
      - ./publish/linux-x64:/app:ro
    environment:
      - RADARR__URL=http://radarr:7878
      - RADARR__APIKEY=your-api-key-here
      - RADARR__TIMEOUTMS=15000
    depends_on:
      - radarr
    stdin_open: true
    restart: unless-stopped

Build the publish artifact first:```bash
dotnet publish -c Release -r linux-x64 --self-contained -o publish/linux-x64


---

## Available Tools

### `radarr_search_movie`
Search for movies by title via Radarr (which queries TMDB). Returns both library movies and new candidates.

**Example:** *"Search for Interstellar"*

| Parameter | Type | Default | Description |
|---|---|---|---|
| `query` | string | required | Movie title to search |
| `limit` | int | `5` | Max results (1–20) |

---

### `radarr_multi_search_movie`
Run several title searches in parallel in one call. Use it instead of calling `radarr_search_movie` repeatedly. Takes at most 50 searches; any beyond that are ignored. Each search returns its own `results` and `error`.

**Example:** *"Search for Heat, Ronin and Collateral"*```json
[{ "query": "Heat", "limit": 3 }, { "query": "Ronin" }, { "query": "Collateral" }]
Parameter Type Description
searchesJson string (JSON array) Array of { query, limit? } (limit defaults to 5, clamped to 1–20)

radarr_get_library

List movies in the Radarr library with optional status filtering and title search.

Example: "Show me all unmonitored movies", "Find movies with 'dark' in the title"

Parameter · Type · Default · Description
filter · string · all · all \ · missing \ · downloaded \ · monitored \ · unmonitored
search · string · null · Case-insensitive title substring filter


radarr_add_movie

Add one or more movies to Radarr by TMDB ID. Fetches full movie metadata automatically and uses sensible defaults for quality profile and root folder.

Example: "Add Dune Part Two and Oppenheimer to Radarr"

Parameter Type Default Description
movies array required Array of { tmdbId, qualityProfileId?, rootFolderPath?, monitored?, searchForMovie? }

radarr_get_movie_details

Get full details of a specific movie by its Radarr ID.

Example: "Show full details for movie ID 42"

Parameter Type Description
radarrId int Radarr-assigned movie ID

radarr_multi_get_details

Get full details of several movies in parallel. Use it instead of calling radarr_get_movie_details repeatedly. Each ID returns either its result or an error.

Example: "Show details for movies 407, 1513 and 464"

Parameter Type Description
radarrIdsJson string (JSON array) Radarr movie IDs, e.g. [407, 1513, 464] (max 100)

radarr_delete_movie

Remove a movie from the library. Optionally delete files from disk.

Example: "Delete movie 42 and remove its files"

Parameter Type Default Description
radarrId int required Radarr movie ID
deleteFiles bool false Also delete files from disk
addImportExclusion bool false Prevent future re-import

radarr_update_movie

Update monitored status or quality profile of a library movie.

Example: "Unmonitor movie 42", "Change quality profile of movie 7 to profile ID 3"

Parameter Type Default Description
radarrId int required Radarr movie ID
monitored bool? null Set monitored state
qualityProfileId int? null Assign a different quality profile

Does not change the root folder or move files — use radarr_move_movies.


radarr_update_movies

Update monitored status or quality profile for several movies in parallel. Takes at most 50 entries; any beyond that are ignored. Each entry returns success and either the updated movie or an error. Does not change the root folder or move files — use radarr_move_movies.

Example: "Unmonitor movies 12 and 15, and set movie 40 to quality profile 4"```json
[{ "radarrId": 12, "monitored": false }, { "radarrId": 15, "monitored": false }, { "radarrId": 40, "qualityProfileId": 4 }]


| Parameter | Type | Description |
|---|---|---|
| `updatesJson` | string (JSON array) | Array of `{ radarrId, monitored?, qualityProfileId? }`; each entry needs at least one of the two optional fields |

---

### `radarr_move_movies`
Move one or more movies to a different root folder via Radarr's bulk movie editor (`PUT /api/v3/movie/editor`). With `moveFiles: true` Radarr physically moves the folders on disk in a background `BulkMoveMovie` job and may rename the movie folder according to its folder naming format. **Destructive — run with `dryRun: true` first.**

Before sending anything, the tool checks that the root folder exists (trailing slash ignored) and that every ID is in the library; if either check fails, nothing is changed. Movies already in the target root folder are reported as `skipped`. The response lists `moved` (or `planned` in dry-run mode) with `id`, `title`, `oldPath`, `newRootFolder`, `newPath`, plus `skipped` and the `queuedCommands` Radarr started for the move.

Radarr updates the paths straight away, but the file transfer runs in the background. When the source and destination root folders are on **different physical volumes**, the transfer is a byte-by-byte copy followed by a delete and can take minutes per movie. To find out when it has finished:

- pass `waitForCompletion: true`: the call polls `GET /api/v3/command/{id}` (every 2 s for the first 30 s, then every 5 s up to 2 min, then every 10 s) until the move command ends or `waitTimeoutSeconds` runs out, and adds a `completion` object to the response; or
- check the `queuedCommands[].id` later with `radarr_get_command`.

`completion.status` is one of:

| Status | Meaning |
|---|---|
| `completed` | Transfer finished and every movie is in the target root folder (`durationSeconds`) |
| `completedWithErrors` | Radarr finished the command but could not transfer some movies: it reverted their paths to the old location (`reverted[]` with `id`, `title`, `currentPath`). See Radarr's logs for the reason |
| `failed` / `aborted` | The command failed: `message`, `errorMessage` (first line of Radarr's exception) |
| `timeout` | Still running when `waitTimeoutSeconds` ran out: `commandId`, `lastStatus`, `lastMessage`. **Not an error:** the paths are already updated and the transfer continues in the background. Check again with `radarr_get_command` |
| `unknown` | No move command was found, or Radarr no longer knows it. Check the movie paths |

Keep `waitForCompletion` off for large batches: the MCP call stays blocked for the whole wait. While it waits, the server sends MCP progress notifications with Radarr's progress message, if the client asked for them.

**Example:** *"Move movies 12, 15 and 40 to /movies/T — show me the plan first"*```json
{ "movieIds": [12, 15, 40], "rootFolderPath": "/movies/T", "moveFiles": true, "dryRun": true }
Parameter Type Default Description
movieIds int[] required Radarr movie IDs (1–100), from radarr_get_library
rootFolderPath string required Destination root folder, as listed by radarr_get_root_folders
moveFiles bool true false = only update the path in Radarr's DB, leave files in place
dryRun bool false Return the plan without changing anything
waitForCompletion bool false Wait for the file transfer to finish and report it in completion. Ignored with dryRun: true or moveFiles: false
waitTimeoutSeconds int 300 Maximum wait, 1–1800 seconds

End-to-end example: moving to another disk

  1. Plan: radarr_move_movies````json { "movieIds": [12, 15], "rootFolderPath": "/mnt/disk2/movies", "dryRun": true } ``` →planned: [{ "id": 12, "oldPath": "/mnt/disk1/movies/Heat (1995)", "newPath": "/mnt/disk2/movies/Heat (1995)" }, ...]`

  2. Move and wait: radarr_move_movies````json { "movieIds": [12, 15], "rootFolderPath": "/mnt/disk2/movies", "waitForCompletion": true, "waitTimeoutSeconds": 600 } ``` →queuedCommands: [{ "id": 4711, "name": "BulkMoveMovie" }],completion: { "status": "timeout", "commandId": 4711, "lastStatus": "started", "lastMessage": "Moving Heat (1995) from '…' to '…' (1/2)", "note": "…" }`

  3. Check again later: radarr_get_command````json { "commandId": 4711 } ``` →{ "id": 4711, "name": "BulkMoveMovie", "status": "completed", "durationSeconds": 842.3, ... }`


radarr_get_command

Check the status of a Radarr command started earlier (GET /api/v3/command/{id}), e.g. the BulkMoveMovie in queuedCommands from radarr_move_movies or the id returned by radarr_command. Use it to confirm that a move between different volumes has really finished.

It returns a compact object: id, name, status (queued / started / completed / failed / aborted), result, queued, started, ended, duration / durationSeconds, message (Radarr's progress text, e.g. Moving X from '…' to '…' (2/2)) and, on failure, errorMessage (first line of the exception) and exception (capped at 2000 characters). Radarr keeps commands only for a limited time: an unknown or purged ID returns a clear error.

Radarr's move job reports completed even when it could not transfer a single movie; in that case it reverts that movie's path. radarr_move_movies with waitForCompletion: true checks for this. With radarr_get_command alone, confirm the paths with radarr_get_movie_details.

Example: "Has the move I started earlier finished?"

Parameter Type Description
commandId int Command ID, from queuedCommands[].id (radarr_move_movies) or id (radarr_command)

radarr_get_queue

Get the current download queue including active and pending items.

Example: "What's currently downloading in Radarr?"

Parameter Type Default Description
includeMovie bool true Include movie metadata in each queue record

radarr_get_cutoff_unmet

List monitored movies that have a file but haven't reached their quality profile's cutoff yet (upgrade candidates). Returns radarrId, title, year, qualityProfileId, current quality and resolution.

Example: "Which movies could still be upgraded?"

No parameters.


radarr_get_root_folders

List the configured root folders with id, path, freeSpace, accessible and unmappedFolderCount.

Example: "Which root folders do I have and how much space is left?"

No parameters.


radarr_get_unmapped_folders

Scan a root folder and list the subfolders on disk that aren't linked to any movie in Radarr. This is the first step of a library import. On large folders the scan can take a few minutes (5-minute timeout).

Example: "Which folders in root folder 2 aren't in Radarr yet?"

Parameter Type Description
rootFolderId int Root folder ID, from radarr_get_root_folders

radarr_import_movies

Import unmapped folders into the library. For each folder, the tool looks up the best TMDB match for folderName and imports it with path set to folderPath, without triggering a search. If the match is already in Radarr, that entry fails with conflict: true and the existing movie's ID/title: delete the existing movie first, then retry (same as the Radarr UI).

Example: "Import the unmapped folder 'Heat (1995)' from /movies/H"json [{ "folderPath": "/movies/H/Heat (1995)", "folderName": "Heat (1995)", "qualityProfileId": 4, "monitored": true }]

Parameter Type Description
imports string (JSON array) Array of { folderPath, folderName, qualityProfileId?, monitored? } (monitored defaults to true)

radarr_command

Send a command to Radarr (POST /api/v3/command) to trigger an action right away, e.g. MoviesSearch, RefreshMovie, RescanMovie, RssSync. Returns the queued command's id, status and timestamps without waiting for it to finish. Use radarr_get_command to follow it.

Example: "Search for new releases of movies 123 and 456"

Parameter Type Default Description
commandName string required Radarr command name, e.g. MoviesSearch
commandArgs string (JSON object) null Extra fields merged into the command body, e.g. {"movieIds": [123, 456]}

radarr_get_system_status

Get Radarr version, system info, and any active health check warnings.

Example: "Is Radarr healthy?"

No parameters.


Architecture Notes

  • Transport: stdio — compatible with Claude Desktop, Claude Code, and any MCP-capable client
  • Resilience: Polly standard pipeline — 2 retries with exponential backoff, per-attempt timeout
  • Logging: all logs go to stderr (stdout is reserved for the MCP protocol)
  • Startup check: on start, the server calls Radarr's /api/v3/system/status; failure is logged as a warning but does not abort startup

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
radarr-mcp 怎么安装?

在客户端按下面的安装命令接入:/path/to/RadarrMcp。装完在客户端配置里引用同一个包或端点。

radarr-mcp 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

radarr-mcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

radarr-mcp 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

radarr-mcp 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

radarr-mcp 能提供哪些能力?

资料显示能力标签包括 Local Deployment、Movie Management、MCP Server、C#、Natural Language Interface、Media Automation。具体工具清单以官方文档为准。

radarr-mcp 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

radarr-mcp 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-09-18。