Sonarr (TV) Connector for AI agents.

18 live capabilities

Manage your TV show library and download queues with natural language.

Live agent request Sonarr (TV) / Connector

Waiting for input…

AI Agent

Why people use Sonarr (TV)

Sonarr (TV) for Managing TV Library Media Files

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 get to stop worrying about the UI and start focusing on your shows, getting the results you want in seconds without the extra clicks.

What Vinkius changes

You get a conversational interface for your entire TV media collection.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Checking for new episodes

A user wants to see if the latest episode of a show is finished.
Real-world use case 02

Clearing out storage

A collector needs to clear space.
Real-world use case 03

Adding new content

A user wants to add a new show.

Complete set · 18capabilities

The complete Sonarr (TV) capability set.

These are the exact actions your AI can choose when you ask it to work with Sonarr (TV).

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 18 available through Sonarr (TV).

01 Capability
Add series
Add a new series to your library. This lets you quickly expand your collection using a TVDB ID.
02 Capability
Delete episode file
Delete an episode file from your disk. Use this to manually clear up storage space on your hard drive.
03 Capability
Delete queue item
Remove an item from your current download queue. This is useful for stopping a download that is no longer needed.
04 Capability
Delete series
Remove a series from your library. Use this to prune your show list and keep your collection organized.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 18 available through Sonarr (TV).

05 Capability
List series
List all series in your library. This is the primary way to see your entire collection at once.
06 Capability
Get episode file
Get the location and details of a specific episode file. This helps you find exactly where your media is stored.
07 Capability
Get episode
Get details for a specific episode by its ID. This is useful for checking the status of a single show entry.
08 Capability
Get health
Get any health check warnings or errors. This is the quickest way to see if your Sonarr instance is struggling.

Capability set03 / 05

09—12

4 capabilities in this set.

Part of 18 available through Sonarr (TV).

09 Capability
Get history
Get the history of grabbed and imported episodes. Use it to see what your Sonarr instance has processed recently.
10 Capability
Get queue
Get all items currently in your download queue. This lets you see exactly what is happening right now.
11 Capability
Get series
Get details for a specific series by its ID. Use this to see the full metadata and details for a show.
12 Capability
Get system status
Get your Sonarr version, OS, and paths. This helps you verify your basic instance configuration.

Capability set04 / 05

13—15

3 capabilities in this set.

Part of 18 available through Sonarr (TV).

13 Capability
List commands
List all currently running commands. Use it to see what background tasks the platform is performing.
14 Capability
List episode files
List all episode files for a specific series. This is great for auditing your local storage files.
15 Capability
List episodes
List all episodes for a specific series. Use it to see the full list of available content for a show.

Capability set05 / 05

16—18

3 capabilities in this set.

Part of 18 available through Sonarr (TV).

16 Capability
Start command
Start a new command like SeriesSearch or RescanSeries. Use it to trigger manual actions on your instance.
17 Capability
Update episode
Update a specific episode, like marking it as monitored. This keeps your library data accurate and up to date.
18 Capability
Update series
Update an existing series in your library. Use it to change show details or monitoring settings easily.

Set up in minutes

One URL. Then ask Sonarr (TV) to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Sonarr (TV) from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Sonarr (TV), and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Sonarr (TV) for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Sonarr (TV) URL.
Step 03

Save and start

Save the connection and enable Sonarr (TV) in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "sonarr-tv": {
      "url": "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Sonarr (TV)

Open Agent mode in chat and ask: "Using Sonarr (TV), help me...". 18 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "sonarr-tv": {
      "url": "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Sonarr (TV)

Ask Copilot: "Using Sonarr (TV), help me...". 18 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "sonarr-tv": {
      "url": "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Sonarr (TV)

Open Cascade and ask: "Using Sonarr (TV), help me...". 18 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "sonarr-tv": {
      "url": "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Sonarr (TV)

Ask Cline: "Using Sonarr (TV), help me...". 18 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add sonarr-tv --transport http "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Sonarr (TV)

Ask Claude: "Using Sonarr (TV), show me...". 18 tools are ready

Where the request belongs

Work Sonarr can move forward.

Built around the request

This is for the media collector who feels overwhelmed by the manual upkeep of a large home library and wants to manage everything through a simple chat interface.

01

Home Lab Enthusiast

Manages a massive PVR setup and wants to check download statuses without opening multiple browser tabs.

02

Media Collector

Wants to quickly add shows or find specific episodes without memorizing TVDB IDs or navigating deep menus.

03

Automation Hobbyist

Wants to build a voice-controlled or chat-based system to manage their personal TV library.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 15 capabilities

Radarr (Movies)

Manage your movie library, search for new titles, and monitor download queues via Radarr.

02 12 capabilities

Jellyfin (Plex Alternative)

Manage your media library via Jellyfin. list movies, shows, and music, track playback progress, and inspect server status directly from any AI agent.

03 18 capabilities

Trakt

Track TV shows and movies. search titles, get ratings, discover trending content and manage your watchlist.

04 15 capabilities

Plex

Manage your Plex Media Server. browse libraries, search media, check active streams and control playback from any AI agent.

05 8 capabilities

Watchmode Streaming Availability

Find where to watch any movie or TV show. search streaming availability across Netflix, Disney+, HBO Max, and 200+ platforms directly from your AI agent.

06 17 capabilities

Limelight Networks (Edgio CDN & Streaming API)

Manage Edgio (formerly Limelight/Uplynk) streaming services. control VOD assets, linear channels, and live events directly through AI.

Bring your own AI

Change the model, client or framework. Keep Sonarr connected.

Before you connect

Questions about Sonarr.

The practical details behind the request, access and result.

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 capability. 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 capability 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 capability to list all items currently in the download queue, including their status and progress.

One connection away

Give your agent a direct line to Sonarr.

Connect Sonarr once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available