An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Sonarr Tv to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage your entire media library through simple chat commands.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 18 capabilities

We ship only the actions that matter.

Capability set01 / 05

01-04

4 capabilities in this set.

Part of 18 available through Sonarr.

  1. 01

    Delete episode file

    This capability removes a specific episode file from your physical storage.

  2. 02

    Delete queue item

    Use this to pull an item out of your active download queue.

  3. 03

    Delete series

    This capability wipes a series from your Sonarr library entirely.

  4. 04

    List series

    This capability returns a full list of every series in your library.

Capability set02 / 05

05-08

4 capabilities in this set.

Part of 18 available through Sonarr.

  1. 05

    Get episode file

    This capability retrieves details about a specific episode file on your disk.

  2. 06

    Get health

    This capability checks for any system warnings or errors within Sonarr.

  3. 07

    Get queue

    This capability pulls the current status of all items in your download queue.

  4. 08

    Get series

    This capability fetches detailed information for a specific series using its ID.

Capability set03 / 05

09-12

4 capabilities in this set.

Part of 18 available through Sonarr.

  1. 09

    Get system status

    This capability provides technical details like version, OS, and file paths.

  2. 10

    List commands

    This capability shows you all commands currently running in the system.

  3. 11

    List episode files

    This capability lists every episode file associated with a specific series.

  4. 12

    Update episode

    Use this to change episode settings, such as marking a show as monitored.

Capability set04 / 05

13-15

3 capabilities in this set.

Part of 18 available through Sonarr.

  1. 13

    Update series

    This capability lets you modify the settings of an existing series in your library.

  2. 14

    Add series

    This capability adds a brand new series to your managed library.

  3. 15

    Get episode

    This capability retrieves data for a specific episode by its ID.

Capability set05 / 05

16-18

3 capabilities in this set.

Part of 18 available through Sonarr.

  1. 16

    Get history

    This capability accesses the log of grabbed and imported episodes.

  2. 17

    List episodes

    This capability returns a list of all episodes belonging to a series.

  3. 18

    Start command

    This capability triggers new system actions like RescanSeries or SeriesSearch.

Real work

What teams actually run

01

Quick Library Checks

Ask your agent if a specific show is in your library or if a new episode is available.

02

Storage Maintenance

Tell your agent to delete specific episode files when you are running low on disk space.

03

Queue Oversight

Check on the progress of your downloads while you are working in your IDE or chat client.

04

System Monitoring

Have your agent check for Sonarr errors or system status updates automatically.

Automate a task

Put Sonarr to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Sonarr works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Sonarr to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1039ms average. Fast in production.

Sonarr is checked daily against the live service.

Daily averagePeak 1253ms
Oct 3Today
Fastest day
813ms
Slowest day
1253ms
14-day trend
Improving-6%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 18 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Sonarr, so you can see the experience inside your AI.

It does not authenticate your account with Sonarr. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Sonarr Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Sonarr capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "sonarr-tv-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_xP8SrYZSACuZcECfY2NS6oNfbK8Q1jdoogIlzikr/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Sonarr in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Sonarr owners hand off.

This MCP is built for people who run automated media stacks and want to interact with them through chat rather than web dashboards.

  • 01

    Media Enthusiasts

    People who want to manage their shows and clean up files without opening a browser.

  • 02

    Home Lab Users

    Users who want to automate show tracking and monitor download health via chat.

  • 03

    Automation Fans

    Users looking to pull their media workflows into their daily AI agent routines.

FAQ

Questions Sonarr owners ask.

  • 01

    How do I connect my Sonarr instance?

    You need to provide your Sonarr URL and your API Key during the setup process on Vinkius.

  • 02

    Which AI clients can I use with this MCP?

    You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I delete files from my hard drive using this?

    Yes, the delete_episode_file capability allows your agent to remove physical files from your storage.

  • 04

    Does this work with my existing Sonarr setup?

    Yes, this MCP connects directly to your existing Sonarr instance using your API credentials.

  • 05

    Can I add new shows through the chat?

    Yes, you can use the add_series capability to add new shows to your library via your agent.

  • 06

    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.

  • 07

    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.

  • 08

    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.

Explore

More in Productivity

Suggestions

Connect Sonarr to Claude, Cursor, ChatGPT & more