# Radarr (Movies) MCP for AI Agents AI Agent Connect > Radarr (Movies) gives your AI agent direct access to your movie library and PVR workflows. You can search for titles, manage your collection, monitor active downloads, and check your system health without leaving your chat window. It bridges the gap between your media library and your agent, making it easy to organize, find, and track your favorite films through simple conversation. ## Overview - **Category:** content-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_mmBxJjjSciuKCSOxyvFlNRyCtPhIO06i59DEVvIq/ai-agent-connect - **Tags:** movies, media-server, pvr, automation, library-management ## Description Imagine you're sitting on your couch and realize you want to add a specific movie to your collection. Instead of opening a browser, navigating to your media library, hunting for the right title in a database, and configuring the quality profiles, you just ask your agent. This Connector lets your agent do the heavy lifting. It can peek into your current library to see what you already have, search for new releases using TMDB data, and set up the download parameters for you. If you're worried about your hard drive filling up, you can just ask for a status update on your disk space or see what's currently in the queue. It handles the tedious parts of media management—the clicking, the searching, and the status checking—so you can just focus on watching. By adding this to the Vinkius catalog, you're basically giving your AI a remote control for your entire home theater setup. It's about moving from manual data entry to just telling your agent what you want to happen. ## Tools ### add_movie Adds a new movie to your Radarr library using a TMDB ID and your preferred quality profile. ### get_disk_space Retrieves current disk space information for your media storage. ### get_history Shows the history of your recent movie grabs and imports. ### get_movie Fetches the full details and metadata for a specific movie in your library. ### get_quality_profiles Lists all available quality profiles like HD-1080p or Ultra-HD. ### get_root_folders Lists the configured root folders where your media is stored. ### get_system_status Returns the current system status of your Radarr instance. ### list_movies Lists every movie currently managed in your Radarr library. ### delete_movie Removes a specific movie from your Radarr library permanently. ### delete_queue_item Removes a specific item from your active download queue. ### execute_command Runs internal system commands like RescanMovie or RenameMovie on your library. ### get_commands Lists the active or recently completed system commands for your library. ### get_queue Shows your current active download queue and progress. ### lookup_movie Searches for movies by name or TMDB ID to find titles to add. ### update_movie Updates the metadata or configuration of an existing movie in your library. ## Prompt Examples **Prompt:** ``` What movies do I have in my library right now? ``` **Response:** ``` I've pulled up your current library. You have **124 movies** managed. Here are some of your recent additions: | Title | Year | Quality | | :--- | :--- | : | | Oppenheimer | 2023 | 4K | | Barbie | 2023 | 1080p | | Dune: Part Two | 2024 | 4K | Would you like to see the full list or get details on a specific one? ``` **Prompt:** ``` Check if I have enough space for a new 4K download. ``` **Response:** ``` Checking your storage... **Drive Status:** - **Main Media Drive:** 450 GB remaining (85% full) - **Downloads Drive:** 1.2 TB remaining (20% full) You have plenty of room on the Downloads drive for a 4K grab, but you might want to clear some space on the Main drive soon. ``` **Prompt:** ``` Search for the movie 'Inception' and tell me its TMDB ID. ``` **Response:** ``` Searching the database for 'Inception'... I found it! - **Title:** Inception - **Year:** 2010 - **TMDB ID:** 27205 It's not currently in your library. Would you like me to add it for you? ``` ## Capabilities ### Add new movies Put a new title into your library with specific quality settings. ### Remove movies Delete any film from your collection instantly. ### Clear the queue Remove specific items from your active download list. ### Run system commands Trigger actions like library refreshes or movie renames. ### Check storage Get real-time disk space info for your media drives. ### View history See a list of your past grabs and imports. ### Fetch movie details Get full metadata for a specific film in your library. ### See quality profiles View your configured quality settings like 1080p or 4K. ### Monitor active downloads Check what's currently being grabbed and its progress. ### List root folders See where your media is actually stored on your system. ### Get system health Check the overall status of your Radarr instance. ### List entire library See every movie currently managed by your library. ### Search for titles Look up movies by name or ID to find what to add next. ### Update movie data Change the configuration or metadata of an existing movie. ## Use Cases ### The Quick Add A user asks to find 'Oppenheimer' and add it to their library in 4K. The agent uses lookup_movie and add_movie to handle the setup. ### The Storage Check A user wants to know if they have room for a big download. The agent calls get_disk_space and reports the remaining GBs. ### The Status Update A user asks what's currently downloading. The agent uses get_queue to provide a progress list of active grabs. ### The Maintenance Task A user wants to refresh their library after moving files. The agent uses execute_command to run the RescanMovie command. ## Benefits - Stop digging through web UIs by using list_movies to see your entire collection instantly. - Save time on content discovery by using lookup_movie to find and add titles via chat. - Keep your storage organized by checking get_disk_space before starting large 4K downloads. - Stay on top of your media pipeline by using get_queue to see exactly what's currently downloading. - Automate repetitive maintenance by using execute_command to trigger library refreshes or renames. - Keep your metadata accurate by using update_movie to change configurations on the fly. ## How It Works The bottom line is you get a conversational interface for your entire movie management backend. 1. Connect your Radarr instance by providing your URL and API Key in your agent's configuration. 2. Grant the agent permission to interact with your library and download queues. 3. Start asking for movie searches, library updates, or system status checks. ## Frequently Asked Questions **Can Radarr (Movies) MCP manage my TV shows?** No, this Connector is specifically designed for managing your movie library. For TV show management, you would need a tool that connects to Sonarr. **Does Radarr (Movies) MCP work with my existing library?** Yes, it connects directly to your existing Radarr instance using your URL and API Key, giving your agent full access to your current collection. **Can I use Radarr (Movies) MCP to see my download progress?** Yes, you can ask your agent to show your active queue at any time. It will report what's currently downloading and how much progress has been made. **How do I add a movie to my library using the Radarr (Movies) MCP?** You can just tell your agent to find a movie and add it. It will search the database, find the correct details, and put it into your library for you. **Can Radarr (Movies) MCP check my hard drive space?** Yes, your agent can check your configured root folders and report exactly how much storage space you have left on your media drives. **Can I use the Radarr (Movies) MCP to refresh my library?** Yes, your agent can execute system commands like 'RescanMovie' to refresh your library metadata whenever you need it. **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.