Radarr (Movies) MCP for AI. Manage your entire media library from chat.

Q: What if I need to update an existing title's metadata?

You use the updatemovie tool. Just make sure you provide the entire movie object payload, because it needs all the data to overwrite the old record correctly.

Q: Can getqueue tell me how long a download will take?

Yes, getqueue provides status updates. It shows the percentage complete and often estimates remaining time for active downloads.

Q: If I need to force a system refresh, which command should I use with executecommand?

Use executecommand and specify a function like 'RescanMovie' or 'RefreshMovie'. This manually forces Radarr to recheck the metadata or folder status without needing an external trigger.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

Radarr (Movies) gives your AI client direct control over your movie collection and PVR workflow. It lets you list movies, search for new titles using TMDB IDs, check the active download queue (`get_queue`), and manage system status—all through natural conversation without touching the web UI.

What your AI can do

Add movie

Adds a new movie to your collection using a TMDB ID, quality profile, and root folder path.

Delete movie

Permanently removes an existing movie record from the Radarr library.

Delete queue item

Removes a specific item from the active download queue before it finishes.

+ 12 more capabilities included

Search for new media titles

Use lookup_movie to find movies by name or TMDB ID, getting the necessary data to add them.

Check download progress and history

View the current queue using get_queue, or review past activity logs with get_history.

Manage library records

List all existing movies (list_movies) or fetch full metadata for a single title (get_movie).

Run system health checks

Get the current disk space and overall Radarr status via get_disk_space and get_system_status.

Execute internal commands

Trigger background tasks like scanning or renaming using execute_command.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

Radarr (Movies) MCP Server: 15 Tools for Media Management

These tools let your AI client interact with every core function of Radarr. Use them to search, update, monitor, and manage your movie collection directly via conversation.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Radarr (Movies) on Vinkius

Add Movie

Adds a new movie to your collection using a TMDB ID, quality profile, and root folder path.

Delete Movie

Permanently removes an existing movie record from the Radarr library.

Delete Queue Item

Removes a specific item from the active download queue before it finishes.

Execute Command

Runs internal Radarr commands like RescanMovie or RefreshMovie to force system...

Get Commands

Lists the history of all executed or active system commands.

Get Disk Space

Retrieves current disk space information for your media storage location.

Get History

Shows a log of all past movie grabs and imports into the library.

Get Movie

Fetches full, detailed metadata for one specific movie title.

Get Quality Profiles

Lists all quality profiles (like HD-1080p) configured in your Radarr setup.

Get Queue

Displays the current list of movies that are actively downloading.

Get Root Folders

Retrieves all root directories where your media files are stored.

Get System Status

Provides a general health check and status report for the entire Radarr server instance.

List Movies

Outputs a full list of every movie currently managed in your library.

Lookup Movie

Searches TMDB for movies using search terms or specific IDs, providing data needed...

Update Movie

Replaces all current metadata and details for an existing movie record in Radarr.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Radarr (Movies) integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "radarr-movies": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Radarr (Movies) tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"radarr-movies": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Radarr (Movies), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Radarr. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 15 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Manually checking library status shouldn't require opening multiple tabs.

Today, finding out what movies are in your collection means navigating to the web UI, clicking 'Library,' and scrolling through pages just to verify a title or count. Then you might open another tab to check download statuses, then maybe hit the system logs if something fails.

With this MCP server, you ask your agent: 'What's going on?' It runs `get_system_status` and consolidates the data. You get an immediate answer in chat—a single source of truth for everything from disk space (`get_disk_space`) to queue health.

The Radarr (Movies) MCP Server gives you direct control over your movie library.

You no longer need to manually search TMDB, copy the ID, open Radarr, and then paste it. Your agent handles that sequence: it runs `lookup_movie` first, gets the ID, and then uses `add_movie` with all required parameters.

This moves your workflow from a clunky web-based process to a simple conversation. You just tell your AI client what you want; it figures out which tool—be it `get_root_folders` or `update_movie`—to use.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

You gotta connect your AI client to this Radarr server. It gives your agent full control over managing your movie collection and the whole PVR workflow right from conversation. Forget clicking through menus; you treat your media library like a database, period. This setup lets your agent handle everything—from searching for new titles to checking if your drives are gonna run out of juice.

Need to find a film? You use lookup_movie to search TMDB by name or ID, getting all the intel you need before adding it. Once you have that data, you can punch in add_movie, specifying the TMDB ID, the quality profile, and the root folder path right away. If something changes on a film you already own, you hit update_movie to replace all the current metadata and details for that title.

Want to see what's actually in your library? You can run list_movies to get an output of every movie managed by Radarr. If you need deep specs on just one film, use get_movie to fetch all the detailed metadata for that specific title.

If something goes wrong or you wanna clean house, remember you can run delete_movie to permanently strip a record from the library. You also got options for maintenance: get_root_folders tells you every main directory where your media lives, and if you need an overall system health check, get_system_status gives it to ya.

For storage space, running get_disk_space shows current disk capacity for your media drives.

Monitoring the download process is simple too. To see what's currently downloading and waiting in line, you run get_queue. If a movie is stuck or you need to skip it, you can use delete_queue_item to yank that specific item right out of the active download queue before it finishes. You can always look back at what happened by running get_history, which gives a log of every past grab and import into the library.

For advanced operations, you got tools for internal commands. Running execute_command lets your agent trigger background tasks like forcing a movie rescan or refreshing metadata. You can check out the history of those system calls using get_commands. Finally, if you wanna see what quality levels Radarr even knows about, run get_quality_profiles to list all configured profiles, making sure your agent always picks the right gear.

Built · Hosted · Managed by Vinkius Radarr (Movies) MCP Server - Manage Movie Library with AI

Server ID 019e38df-f99c-7171-ac19-81c8c2bba184

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Here's how it actually works

The bottom line is that your AI client runs Radarr functions directly, letting you manage media without touching the web interface.

Subscribe to the server and provide your Radarr URL and API Key.

Your AI client connects, authenticating access to the defined tools (e.g., list_movies).

You simply ask your agent: 'What movies do I need to add?' The agent uses the correct tool (lookup_movie) and executes the action.

Who is this actually for?

Anyone running a dedicated home media server who hates opening a browser just to check if a download finished or list titles. This is for the sysadmin who needs quick status checks and the collector who wants to add movies without clicking through 10 different pages.

System Administrator

Checks disk space using get_disk_space or monitors overall system health with get_system_status when troubleshooting.

Content Collector

Searches for new movies via lookup_movie and uses the agent to add them directly to the watchlist, skipping manual web steps.

Home Lab Enthusiast

Manages the entire PVR stack by checking the download queue (get_queue) and running cleanup commands with delete_movie.

What Changes When You Connect

Stop opening the web UI. With list_movies, you can get a complete inventory of every movie in your collection instantly, right in the conversation window.

You don't have to remember IDs. Use lookup_movie with just a title name, and your agent finds the TMDB ID for you, prepping it for addition.

Need to know if something broke? Call get_system_status. It checks the server health and tells you immediately if Radarr is having issues.

Manage downloads without logging in. The get_queue tool shows exactly what's downloading right now and how much time it has left.

Fix bad data or outdated info by calling update_movie, ensuring all your records have the latest metadata payload.

See it in action

01 01

Inventory Check

You need to know how many movies you own before talking to a friend. Instead of clicking through multiple pages, you ask your agent: 'List all movies.' The tool runs list_movies and gives you the count and titles instantly.

02 02

Adding Missing Titles

You find a movie link but don't know its TMDB ID. You ask your agent to search for it using lookup_movie. The tool returns the ID, which you can then pass to add_movie right away.

03 03

Troubleshooting Downloads

A movie download stalled and you're not sure why. You ask your agent to check the status using get_queue. The tool runs, showing if it's stuck or how many minutes are left until completion.

04 04

Cleanup Mode

You finished a movie and want to remove its record from Radarr. You tell your agent: 'Delete the movie X.' The tool calls delete_movie, keeping your library clean without manual deletion steps.

The honest tradeoffs

Over-relying on descriptions

Anti-pattern

Asking the agent to 'just figure out what needs updating.' The server can't guess; it only knows specific tools.

The Fix

Be explicit. If you need data, use get_movie. If you need to add something, use lookup_movie followed by add_movie.

Manual workflow steps

Anti-pattern

Getting the list of movies from one tool (list_movies) and then trying to manually feed those names into another process.

The Fix

Let the agent chain calls. For example, ask the agent to 'List all movies in HD quality'—it handles the filtering using specific tools.

Assuming full control

Anti-pattern

Thinking you can simply run a command without knowing its exact syntax or required payload structure.

The Fix

Check the documentation for execute_command. You must specify commands like 'RescanMovie' to make it work.

When It Fits, When It Doesn't

Use this server if your primary pain point is managing a large, structured collection of media metadata and you need API-level control over state changes. This means needing to perform CRUD operations (Create via add_movie, Read via list_movies or get_movie, Update via update_movie, Delete via delete_movie). Don't use this if you just want simple file system access—it manages metadata, not the files themselves. If your goal is only to check what's downloading, get_queue handles that fine, but if you need to change anything (add, delete, update), you need the full suite of tools.

Questions you might have

How do I find out how many movies are in my Radarr library using list_movies? +

The tool returns a full list of every movie title and its metadata. The agent counts the records for you, giving you an immediate total count without requiring any manual counting.

Do I need to use get_movie to check one title's details? +

Yes. If you only want specific info on a single movie—like its release date or quality profile—you call get_movie with the ID instead of listing everything.

What if I need to update an existing title's metadata? +

You use the update_movie tool. Just make sure you provide the entire movie object payload, because it needs all the data to overwrite the old record correctly.

Can get_queue tell me how long a download will take? +

Yes, get_queue provides status updates. It shows the percentage complete and often estimates remaining time for active downloads.

How do I check all configured storage paths using get_root_folders? +

The tool returns a list of every root folder Radarr uses. This confirms where your media files are stored and ensures the agent targets the correct directory for operations.

What is the proper search syntax when I use lookup_movie? +

You must specify the movie using either a general term, like "term=Dune", or the precise TMDB ID, such as "term=tmdb:550". This helps ensure accurate identification before adding the title.

If I need to force a system refresh, which command should I use with execute_command? +

Use execute_command and specify a function like 'RescanMovie' or 'RefreshMovie'. This manually forces Radarr to recheck the metadata or folder status without needing an external trigger.

Where can I view my past media grabs and imports using get_history? +

The function provides a chronological log of all activity, including successful grabs, imports, and any associated errors. This is useful for auditing what the agent has done previously.

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

Yes! Use the lookup_movie tool 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 tool. 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 tool, you can set the deleteFiles parameter to true to ensure the media is wiped from your storage.

Connect to your AI in seconds.

Add movie

Delete movie

Delete queue item

Radarr (Movies) MCP Server: 15 Tools for Media Management

Make your AI actually useful.

Add Movie

Delete Movie

Delete Queue Item

Execute Command

Get Commands

Get Disk Space

Get History

Get Movie

Get Quality Profiles

Get Queue

Get Root Folders

Get System Status

List Movies

Lookup Movie

Update Movie

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Manually checking library status shouldn't require opening multiple tabs.

The Radarr (Movies) MCP Server gives you direct control over your movie library.

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Inventory Check

Adding Missing Titles

Troubleshooting Downloads

Cleanup Mode

The honest tradeoffs

Over-relying on descriptions

Manual workflow steps

Assuming full control

When It Fits, When It Doesn't

Questions you might have