# Sonarr (TV) MCP for AI Agents AI Agent Connect > Sonarr (TV) lets you manage your entire TV show library using natural language. Instead of clicking through menus, you can ask your AI agent to find shows, track new episodes, check your download queue, and clean up old files. It turns your media setup into a conversational interface for managing your personal collection. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/ai-agent-connect - **Tags:** media-management, pvr, automation, rss-feeds, tv-shows, library-tracking ## Description Managing a massive library of TV shows usually feels like a part-time job. You spend your time jumping between your browser to check the Sonarr dashboard, opening your file explorer to see where things landed, and keeping a tab open just to watch the download progress of your favorite shows. It is a lot of manual clicking for a hobby that is supposed to be relaxing. This Connector changes the experience by putting your library's controls into a single chat window. Instead of hunting for buttons, you just tell your agent what you need. You can ask it to find a specific show, see what is currently downloading, or tell it to clear out space by deleting finished files. It handles the heavy lifting of interacting with the Sonarr API so you do not have to remember specific commands or navigate a complex web UI. Whether you are trying to organize a new collection or just want to check the status of a show you are binge-watching, you can do it from one chat window. By connecting this to the Vinkius catalog, you get a reliable way to keep your media organized without the manual overhead. It is about moving from how do I click this to just get me that show, making your home media setup feel much more responsive and less like a chore. ## Tools ### add_series Add a new series to your library. This lets you quickly expand your collection using a TVDB ID. ### delete_episode_file Delete an episode file from your disk. Use this to manually clear up storage space on your hard drive. ### delete_queue_item Remove an item from your current download queue. This is useful for stopping a download that is no longer needed. ### delete_series Remove a series from your library. Use this to prune your show list and keep your collection organized. ### list_series List all series in your library. This is the primary way to see your entire collection at once. ### get_episode_file Get the location and details of a specific episode file. This helps you find exactly where your media is stored. ### get_episode Get details for a specific episode by its ID. This is useful for checking the status of a single show entry. ### get_health Get any health check warnings or errors. This is the quickest way to see if your Sonarr instance is struggling. ### get_history Get the history of grabbed and imported episodes. Use it to see what your Sonarr instance has processed recently. ### get_queue Get all items currently in your download queue. This lets you see exactly what is happening right now. ### get_series Get details for a specific series by its ID. Use this to see the full metadata and details for a show. ### get_system_status Get your Sonarr version, OS, and paths. This helps you verify your basic instance configuration. ### list_commands List all currently running commands. Use it to see what background tasks the platform is performing. ### list_episode_files List all episode files for a specific series. This is great for auditing your local storage files. ### list_episodes List all episodes for a specific series. Use it to see the full list of available content for a show. ### start_command Start a new command like SeriesSearch or RescanSeries. Use it to trigger manual actions on your instance. ### update_episode Update a specific episode, like marking it as monitored. This keeps your library data accurate and up to date. ### update_series Update an existing series in your library. Use it to change show details or monitoring settings easily. ## Prompt Examples **Prompt:** ``` Show me what's currently downloading. ``` **Response:** ``` ### Current Download Queue | Show | Episode | Progress | | :--- | :--- | :--- | | **The Bear** | S02E01 | 65% | | **Succession** | S04E10 | Queued | Your history shows 5 successful imports today. Would you like me to pause or remove any of these items? ``` **Prompt:** ``` Are there any errors with my Sonarr instance? ``` **Response:** ``` I checked the system health for you. Here is what I found: * **Status:** Warning * **Issue:** A disconnected path was detected in your storage directory. * **Action:** You might want to check your hard drive connections to ensure your files are being saved correctly. ``` **Prompt:** ``` Add 'The Bear' to my library. ``` **Response:** ``` I've successfully added **The Bear** to your library. I've also set it to be monitored so you'll get notified of new episodes as they become available. ``` ## Capabilities ### Add new shows to your library Tell your agent to include a new series using its TVDB ID. ### Track episode status See exactly which episodes of a show are monitored or already downloaded. ### Monitor download progress Get a live look at what is in your queue and how much is left. ### Clean up storage Identify and remove physical episode files from your hard drives to save space. ### Check system health Instantly see if your Sonarr instance is running correctly or reporting errors. ### Manage series details Update show information or change quality profiles on the fly. ## Use Cases ### Checking for new episodes A user wants to see if the latest episode of a show is finished. They ask the agent, and it checks the status using get_episode. ### Clearing out storage A collector needs to clear space. They tell the agent to find all finished episodes of a specific show and delete the files using delete_episode_file. ### Adding new content A user wants to add a new show. They say, Add The Last of Us to my library, and the agent uses add_series with the correct ID. ### Troubleshooting errors A user wants to know if their media setup is healthy. They ask the agent to check for errors, and it runs get_health to report the status. ## Benefits - Stop clicking through menus by using list_series to see your entire collection in one chat. - Free up hard drive space quickly by asking your agent to use delete_episode_file on old content. - Stay on top of your downloads without refreshing pages by using get_queue to see active progress. - Keep your library accurate with update_episode to manage monitoring states without opening the web UI. - Fix instance issues faster by using get_health to see real-time warnings and errors instantly. - Add new shows effortlessly by using add_series with a TVDB ID instead of manual entry forms. ## How It Works The bottom line is you get a conversational interface for your entire TV media collection. 1. Provide your Sonarr URL and API Key in the configuration. 2. Connect your preferred AI client to the Connector. 3. Ask questions about your library or give commands to manage your shows. ## Frequently Asked Questions **Can the Sonarr (TV) MCP help me manage my TV shows?** Yes, it lets you use natural language to add shows, track episodes, and manage your whole library without using the web interface. **How does the Sonarr (TV) MCP handle my download queue?** You can ask your agent to show you what's currently downloading or even remove items from the queue just by asking. **Can I use the Sonarr (TV) MCP to save disk space?** Yes, you can ask your agent to find and delete specific episode files from your storage to clear up room. **Does the Sonarr (TV) MCP work with my existing library?** It connects directly to your current Sonarr instance, giving you full control over your existing shows and series. **Can I check if my Sonarr instance is running okay?** You can ask the agent to check the system health, and it will report any warnings or errors it finds instantly. **Is the Sonarr (TV) MCP good for home lab users?** It is perfect for home lab setups where you want to manage complex PVR workflows through a simple chat interface. **Can I add a new TV series to my library using this agent?** Yes! Use the `add_series` tool. You will need to provide the title, TVDB ID, and the root folder path where the files should be stored. **How do I check if Sonarr is running correctly or has any errors?** You can use the `get_health` tool to see any active health checks or `get_system_status` to retrieve general system information and version details. **Is it possible to see what is currently being downloaded?** Absolutely. Use the `get_queue` tool to list all items currently in the download queue, including their status and progress.