Vinkius
Sonarr (TV)

Supercharge your AI with Sonarr (TV). Manage your entire media library from chat.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Sonarr (TV) MCP on Cursor AI Code Editor MCP Client Sonarr (TV) MCP on Claude Desktop App MCP Integration Sonarr (TV) MCP on OpenAI Agents SDK MCP Compatible Sonarr (TV) MCP on Visual Studio Code MCP Extension Client Sonarr (TV) MCP on GitHub Copilot AI Agent MCP Integration Sonarr (TV) MCP on Google Gemini AI MCP Integration Sonarr (TV) MCP on Lovable AI Development MCP Client Sonarr (TV) MCP on Mistral AI Agents MCP Compatible Sonarr (TV) MCP on Amazon AWS Bedrock MCP Support

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.

+ 15 more capabilities included
View Library Contents

List all series currently tracked in your media library or retrieve a specific show's details.

Manage Episode Files

Get file paths for a specific episode, list all files belonging to a series, or delete physical episode files from disk.

Control Download Queue

View every item waiting in the download queue (get_queue) and remove items that are stalled or unnecessary (delete_queue_item).

Update Show Statuses

Mark episodes as monitored, update an entire series entry, or add brand new series to your tracking list.

Audit System Health

Check Sonarr’s overall connectivity status (get_system_status) and access the download history of all past grabs and imports.

Compatible AI Apps

OAuth 2.0 Compatible
Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
Vinkius runs on Zendesk Zendesk
+ any other MCP app
Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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.

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.

Claude AI

Claude AI

1

Open Claude Settings

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

2

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.

3

Start a conversation

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

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 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
Sonarr (TV) MCP server cover

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

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 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.

Built · Hosted · Managed by Vinkius Sonarr (TV) MCP Server - Manage Media Library & Files
Server ID 019e38f0-af19-73fc-ae57-5fec4b3c5f8e
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

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.

Built & Managed by Vinkius 30s setup 18 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.