How do I connect my Radarr instance?

You just need to provide your Radarr URL and your API Key when you subscribe to the MCP on Vinkius.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I add movies directly from the chat?

Yes, you can search for movies via TMDB and add them to your library using the add_movie capability.

Does this MCP host my movies?

No, this MCP connects to your existing Radarr instance. Vinkius only hosts the connector that lets your AI talk to your server.

Can I check if my downloads are finished?

Yes, you can use the get_queue capability to see the status of your current downloads.

Can I search for movies on TMDB before adding them to my library?

Yes! Use the lookup_movie capability with a search term. The agent will return potential matches from TMDB, which you can then add using add_movie.

How do I check if I have enough disk space for new downloads?

Simply ask the agent to run the get_disk_space capability. It will provide a list of all connected drives and their available capacity.

Is it possible to remove a movie and its files from the disk simultaneously?

Yes. When using the delete_movie capability, you can set the deleteFiles parameter to true to ensure the media is wiped from your storage.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Radarr Movies to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Control your entire media library through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 15 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through Radarr.

01
Get history
View your recent activity by checking the history of grabs and imports.
02
Get movie
Retrieve specific metadata and details for a single movie in your library.
03
Get quality profiles
List the quality profiles, like HD-1080p or Ultra-HD, that you have configured.
04
Get root folders
Identify the root folders where your media is organized.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through Radarr.

05
List movies
Pull a full list of every movie currently in your Radarr library.
06
Execute command
Run internal Radarr system commands such as RescanMovie or RefreshMovie.
07
Get commands
Check the status of active or recently finished system commands.
08
Update movie
Modify the settings or metadata for an existing movie in your collection.

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through Radarr.

09
Add movie
Add a new title to your library using a TMDB ID and your preferred quality settings.
10
Delete movie
Remove a movie from your Radarr library entirely.
11
Delete queue item
Clear a specific item from your active download queue.
12
Get disk space
Check how much storage space is available on your system.

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through Radarr.

13
Get queue
See what is currently downloading by pulling the active queue.
14
Get system status
Get a high level overview of your Radarr system status.
15
Lookup movie
Search for movies by name or TMDB ID to prepare them for addition.

Real work

What teams actually run

Quick Additions

Ask your agent to find a specific movie and add it to your library with your preferred quality profile.

Queue Checks

Check how much longer a movie download will take without opening the Radarr dashboard.

Storage Audits

Ask your agent for disk space info to see if you have room for new additions.

Library Cleanup

Tell your agent to remove specific movies or clear items from your download queue.

Automate a task

Put Radarr to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Radarr works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Radarr to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1025ms average. Fast in production.

Radarr is checked daily against the live service.

Daily averagePeak 1318ms

Oct 3Today

Fastest day: 880ms
Slowest day: 1318ms
14-day trend: Improving-8%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 15 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Radarr, so you can see the experience inside your AI.

It does not authenticate your account with Radarr. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Radarr Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_mmBxJjjSciuKCSOxyvFlNRyCtPhIO06i59DEVvIq/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Radarr capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "radarr-movies-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_mmBxJjjSciuKCSOxyvFlNRyCtPhIO06i59DEVvIq/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Radarr in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Radarr owners hand off.

This MCP is built for people running home media servers who want to skip the web interface.

01
Home Lab Enthusiasts
Manage media servers through chat instead of opening a browser.
02
Content Collectors
Quickly find and add movies to watchlists using natural language.
03
System Administrators
Monitor disk space and download health across a media stack.

FAQ

Questions Radarr owners ask.

01
How do I connect my Radarr instance?
You just need to provide your Radarr URL and your API Key when you subscribe to the MCP on Vinkius.
02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I add movies directly from the chat?
Yes, you can search for movies via TMDB and add them to your library using the add_movie capability.
04
Does this MCP host my movies?
No, this MCP connects to your existing Radarr instance. Vinkius only hosts the connector that lets your AI talk to your server.
05
Can I check if my downloads are finished?
Yes, you can use the get_queue capability to see the status of your current downloads.
06
Can I search for movies on TMDB before adding them to my library?
Yes! Use the lookup_movie capability with a search term. The agent will return potential matches from TMDB, which you can then add using add_movie.
07
How do I check if I have enough disk space for new downloads?
Simply ask the agent to run the get_disk_space capability. It will provide a list of all connected drives and their available capacity.
08
Is it possible to remove a movie and its files from the disk simultaneously?
Yes. When using the delete_movie capability, you can set the deleteFiles parameter to true to ensure the media is wiped from your storage.

Explore

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get history

Get movie

Get quality profiles

Get root folders

05-08

List movies

Execute command

Get commands

Update movie

09-12

Add movie

Delete movie

Delete queue item

Get disk space

13-15

Get queue

Get system status

Lookup movie

What teams actually run

Quick Additions

Queue Checks

Storage Audits

Library Cleanup

Building your own app? The connector is yours to use.

Radarr Connector

Claude Desktop

Home Lab Enthusiasts

Content Collectors

System Administrators

How do I connect my Radarr instance?

Which AI clients can I use with this MCP?

Can I add movies directly from the chat?

Does this MCP host my movies?

Can I check if my downloads are finished?

Can I search for movies on TMDB before adding them to my library?

How do I check if I have enough disk space for new downloads?

Is it possible to remove a movie and its files from the disk simultaneously?

WordPress Media Uploader AI Connector

Plex AI Connector

MediaSilo AI Connector

Sonarr (TV) AI Connector

Suggestions

Later (Social Media Management) AI Connector

Hootsuite (Social Media Management) AI Connector

Cincopa AI Connector

Movie Watchtime Calculator AI Connector