# Radarr (Movies) MCP > 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. ## Overview - **Category:** content-management - **Price:** Free - **Tags:** movies, media-server, pvr, automation, library-management ## Description 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. ## Tools ### 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 updates. ### 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 to add them. ### update_movie Replaces all current metadata and details for an existing movie record in Radarr. ## Prompt Examples **Prompt:** ``` List all movies currently in my Radarr library. ``` **Response:** ``` I've retrieved your library. You have 124 movies managed. Recent additions include 'Oppenheimer' and 'Barbie'. Would you like details on a specific title? ``` **Prompt:** ``` Search for the movie 'Inception' and tell me its TMDB ID. ``` **Response:** ``` Searching TMDB... I found 'Inception' (2010) with TMDB ID: 27205. It's currently not in your library. Would you like me to add it? ``` **Prompt:** ``` Show me the current download queue and estimated completion times. ``` **Response:** ``` Checking the queue... You have 2 active downloads: 'Dune: Part Two' (65% complete, ~10 mins left) and 'Poor Things' (12% complete, ~45 mins left). ``` ## Capabilities ### 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`. ## Use Cases ### 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. ### 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. ### 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. ### 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. ## Benefits - 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. ## How It Works The bottom line is that your AI client runs Radarr functions directly, letting you manage media without touching the web interface. 1. Subscribe to the server and provide your Radarr URL and API Key. 2. Your AI client connects, authenticating access to the defined tools (e.g., `list_movies`). 3. You simply ask your agent: 'What movies do I need to add?' The agent uses the correct tool (`lookup_movie`) and executes the action. ## Frequently Asked Questions **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.