sonarr

Search and add TV shows to Sonarr. Supports monitor options, search-on-add.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

The Sonarr Claude skill provides a powerful natural language interface for managing your TV show library. It automates the interaction with Sonarr's API, allowing users to search for series, monitor new episodes, and manage library content directly through the AI agent, streamlining home media server automation.

Use Cases

  • Automated Series Discovery: Search for new TV shows using natural language and add them to your Sonarr library with specific monitoring and quality settings.
  • Library Audit and Management: Quickly check if a specific series already exists in your collection and manage your library by removing unwanted shows with safety-first file deletion prompts.
  • Media Workflow Integration: Seamlessly integrate TVDB metadata into your media management workflow by retrieving clickable links and show details during the search process.
  • Remote Server Configuration: Retrieve root folder paths and quality profiles from your Sonarr instance to ensure new content is organized and downloaded in the desired format.
namesonarr
version1.0.0
descriptionSearch and add TV shows to Sonarr. Supports monitor options, search-on-add.
metadata{"clawdbot":{"emoji":"📺","requires":{"bins":["curl","jq"]}}}

Sonarr

Add TV shows to your Sonarr library.

Setup

Create ~/.clawdbot/credentials/sonarr/config.json:

{
  "url": "http://localhost:8989",
  "apiKey": "your-api-key",
  "defaultQualityProfile": 1
}
  • defaultQualityProfile: Quality profile ID (run config to see options)

Workflow

  1. Search: search "Show Name" - returns numbered list
  2. Present results with TVDB links - always show clickable links
  3. Check: User picks a number
  4. Add: Add show and start search

Important

  • Always include TVDB links when presenting search results to user
  • Format: [Title (Year)](https://thetvdb.com/series/SLUG)
  • Uses defaultQualityProfile from config; can override per-add

Commands

Search for shows

bash scripts/sonarr.sh search "Breaking Bad"

Check if show exists in library

bash scripts/sonarr.sh exists <tvdbId>

Add a show (searches immediately by default)

bash scripts/sonarr.sh add <tvdbId>              # searches right away
bash scripts/sonarr.sh add <tvdbId> --no-search  # don't search

Remove a show

bash scripts/sonarr.sh remove <tvdbId>                # keep files
bash scripts/sonarr.sh remove <tvdbId> --delete-files # delete files too

Always ask user if they want to delete files when removing!

Get root folders & quality profiles (for config)

bash scripts/sonarr.sh config