Supercharge your AI with Sonarr (TV). Manage your entire media library from chat.
Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Sonarr (TV) MCP Server handles your entire TV media library through chat commands. It lets you list series, add new shows via ID, track episode status, and delete physical files directly from your storage using any AI agent.
What your AI can do
Add series
Adds a new TV show series to the library using its identifier.
Delete episode file
Removes a specific episode file from your local disk storage.
Delete queue item
Stops and removes one item that is currently waiting in the download queue.
List all series currently tracked in your media library or retrieve a specific show's details.
Get file paths for a specific episode, list all files belonging to a series, or delete physical episode files from disk.
View every item waiting in the download queue (get_queue) and remove items that are stalled or unnecessary (delete_queue_item).
Mark episodes as monitored, update an entire series entry, or add brand new series to your tracking list.
Check Sonarr’s overall connectivity status (get_system_status) and access the download history of all past grabs and imports.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 CompatibleWaiting for input…
Sonarr (TV) MCP Server: 18 Tools for Media Control
These tools allow your AI client to perform every function Sonarr handles—from listing metadata to deleting physical episode files—all without a web interface.
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 Sonarr (TV) on VinkiusAdd Series
Adds a new TV show series to the library using its identifier.
Delete Episode File
Removes a specific episode file from your local disk storage.
Delete Queue Item
Stops and removes one item that is currently waiting in the download queue.
Delete Series
Removes an entire series entry from your tracked library.
Get Episode File
Returns the file path and details for a specific, finished episode file.
Get Episode
Retrieves all metadata for a single episode using its unique ID number.
Get Health
Checks Sonarr for any warnings or errors regarding system connectivity.
Get History
Shows a log of all episodes that have been successfully grabbed and imported into...
Get Queue
Lists every item currently waiting or processing in the download queue.
Get Series
Retrieves all metadata for a specific series using its unique ID number.
Get System Status
Returns general system information, like the running version and configured paths.
List Commands
Lists all command types that are currently available to run against the server.
List Episode Files
Returns a list of all physical episode files saved for an entire series.
List Episodes
Gets a complete catalog of every known episode within a specific series.
List Series
Returns the names and details for every show currently tracked in your library.
Start Command
Initiates a new, specific command like a series search or refresh process.
Update Episode
Changes the status of an existing episode, such as marking it as monitored.
Update Series
Updates metadata for a whole series, like changing its quality profile.
Connect to your AI in seconds. 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.
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
Make Your AI Do More
Start with Sonarr (TV), then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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 Sonarr. 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
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 18 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Tidying up media servers shouldn't feel like archaeology.
Today, cleaning up your media server means logging into the web interface. You navigate to downloads, click 'History,' find a series, check if it needs an update, and then manually delete old files that are taking up space but aren't linked to anything. It’s clicking through five different pages just to run one simple cleanup job.
With this MCP server, you tell your agent: 'Clean up all episode files for Series X older than last month.' The agent handles the multi-step process: it lists the files (`list_episode_files`), checks their age (via internal logic), and executes `delete_episode_file`—all in one go. You get a clean status report, and your disk space is instantly clearer.
Sonarr (TV) MCP Server: Manage episode files from chat.
Manual file management involves checking the web interface's 'File Paths' tab. You have to copy and paste paths or manually delete them, which is slow and error-prone, especially when dealing with hundreds of episodes.
Now, you simply ask your agent to run `get_episode_file` for a specific ID. It returns the exact path. Need it gone? A single call to `delete_episode_file` does the job. The difference is speed and reliable execution.
What your AI can actually do with this
Sonarr's got your back. Connect your AI agent to this server, and you get total command over your whole TV media library—no need to open up that clunky web interface. You control everything here, from deleting old files off your disk to managing what's sitting in the download queue.
Viewing Your Library Contents
Need to know what shows you're running? Use list_series to get a rundown of every show currently tracked on your setup. If you want deep info on one specific title, run get_series with its unique ID number. To see the full scope of episodes for any given series, list_episodes gives you a complete catalog of everything known about that show.
For details on just one episode's metadata, get_episode takes an ID and spits out all the associated data.
Handling Episode Files
You got files taking up space? Use delete_episode_file to manually wipe a specific episode file off your local storage. You can also run list_episode_files to see every physical file saved for an entire series, helping you know exactly what's there before you delete it. To get the actual path and details of a finished episode file, use get_episode_file.
When you need to adjust something about an existing show or episode—like marking it as monitored—you run update_episode for single titles, or update_series if you're changing metadata for the entire series.
Managing Your Download Queue and History
Is something stuck in the download line? Use get_queue to list every item waiting or processing right now. If an item is stalled or unnecessary, you can stop it and clear it with delete_queue_item. You always wanna keep track of what's been grabbed before; get_history shows a detailed log of all episodes that successfully imported into your library.
System Health and Setup
You gotta know if the system is actually talking to everything right. Run get_health to check Sonarr for any warnings or errors regarding connectivity status. For general machine info, like the installed version and configured paths, use get_system_status. If you need a full list of commands available on this server, run list_commands.
To start a specific process—like initiating a series search or refreshing data—you just call start_command.
Adding and Deleting Series
Got a new show you wanna track? You use add_series, providing its unique identifier to get it into the library. If a show leaves your tracking list, run delete_series to remove the entire series entry from your monitored collection.
019e38f0-af19-73fc-ae57-5fec4b3c5f8e Here's how it actually works
The bottom line is: You talk to your agent, and it talks directly to Sonarr for you.
Subscribe to this server, then provide your Sonarr URL and API Key.
Instruct your AI agent with a natural language request (e.g., 'List all my series').
The agent calls the correct tool (list_series), fetches the data, and presents you with actionable results.
Who is this actually for?
This is for anyone who manages a large media collection (personal or professional). It’s the home lab user who hates clicking through dashboards at 2 AM. If you spend time checking if your downloads are stuck, deleting old files, or logging series details in a web UI, this server saves your fingers.
Manages the personal media library by listing all shows (list_series), checking episode statuses, and cleaning up old files without touching the main Sonarr interface.
Automates show tracking and monitors download health. They use get_queue to see if anything is stuck or needs manual intervention.
Integrates media server workflows into larger operational scripts, using tools like add_series to programmatically manage content acquisition pipelines.
What Changes When You Connect
File Cleanup: Don't manually search for old files. Use delete_episode_file to delete specific episode files directly from the agent, freeing up disk space instantly.
Tracking Status: Need to know if a show is still being monitored? Run get_series or list_episodes. You get immediate status updates without opening any web dashboard.
Queue Management: Downloads stuck in limbo are common. Use get_queue to see what's running, and then use delete_queue_item to clear out stalled processes when you need them gone.
Zero Setup Effort: Forget remembering complex API calls or navigating deep menus. Just ask your agent: 'What series do I have?' and it runs list_series for you.
Audit Trail: Need proof of what was imported? Use get_history. It gives you a clear log of all episodes successfully added, which is better than digging through logs yourself.
See it in action
The Clean-up Crew
You realize your storage drive is full of old, unused show files. Instead of manually browsing the directories and deleting things, you ask your agent to run list_episode_files for a series, verify the names, and then tell it to execute delete_episode_file on the junk entries.
The Newbie Show
A friend gives you a new show's name. You don't want to manually check if Sonarr tracks it. Your agent runs add_series, sends the necessary identifiers, and immediately gets the series added to your monitored library.
The Stuck Download
You know an important season is downloading but it seems frozen in the queue. You ask the agent to run get_queue. Seeing the status, you realize it's stuck and use delete_queue_item to remove it and restart the process cleanly.
The Status Check
You just started your workday. Before opening anything, you ask: 'What shows are currently monitored?' The agent runs list_series, giving you a quick overview of the whole library's status in seconds.
The honest tradeoffs
Assuming file names are enough
Telling your agent, 'Delete the episode called Last Night.' The server fails because it needs a precise ID or path, not just the title.
Always let the agent run get_episode first to get the specific Episode ID. Then use that ID when calling delete_episode_file. Precision matters.
Overwriting metadata
Manually updating a series name in the UI, then forgetting to sync it with Sonarr's tracking data.
Use the update_series tool. It ensures that when you change show details (like quality profiles), Sonarr logs and handles the metadata update correctly.
Confusing status and files
Asking the agent to 'Check if I have Season 5.' The agent can't answer because it doesn't know if you mean metadata or physical files.
Be specific: ask list_episodes for metadata, or run list_episode_files to check the physical disk presence.
When It Fits, When It Doesn't
Use this MCP Server if your primary pain point is managing a large collection of discrete files and their associated metadata. You need programmatic control over file paths, queue items, and status updates—things that are difficult or impossible to automate through simple web forms.
Don't use it if you only want general advice on TV shows (that's better handled by a search engine). Also, don't rely on this for initial setup; always set up Sonarr via its own UI first. This tool is for maintenance and scripted actions, not creation.
Questions you might have
How do I list all series using Sonarr (TV) MCP Server? +
Run list_series. This tool fetches and returns a complete catalog of every show currently tracked in your library, giving you an immediate overview.
Can I delete files with the Sonarr (TV) MCP Server? Which tool do I use? +
Yes, use delete_episode_file. You need to provide the specific episode file's path or ID when calling this function. This deletes physical files from your disk.
What if my download is stuck? Can I check it with Sonarr (TV) MCP Server? +
You can use get_queue. This tool shows everything waiting in the queue, and you can then run delete_queue_item to clear out anything that's stalled.
How do I find all episodes for a specific show? +
Run list_episodes. This tool takes a Series ID and returns a complete list of every episode associated with that series in your library metadata.
How do I check for operational errors or warnings using the `get_health` tool? +
It reports any system health warnings or errors found in your Sonarr installation. This is essential for troubleshooting, as it surfaces connectivity issues or configuration problems before they stop your media acquisition.
What steps do I take if I want to add a brand new TV series using the `add_series` tool? +
The add_series tool creates the entry for a show in your library. You must provide identification details, like the TVDB ID or name, so Sonarr knows exactly what content you're tracking.
How do I get a complete inventory of physical episode files for a series using `list_episode_files`? +
This tool returns all local file paths associated with an entire series. Use this when you need to audit your storage, confirm which episodes are on disk, or prepare for manual cleanup.
If I manually verify an episode's status, how do I update it using the `update_episode` tool? +
The update_episode tool changes the monitored state of a specific show. This is useful after you've manually downloaded or confirmed an episode's availability outside Sonarr.
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.
We've already built the connector for Sonarr (TV). Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 18 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.