---

name: sonarr version: 1.0.0 description: Search 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:

Copy{
  "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

Copybash scripts/sonarr.sh search "Breaking Bad"

Check if show exists in library

Copybash scripts/sonarr.sh exists <tvdbId>

Add a show (searches immediately by default)

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

Remove a show

Copybash 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)

Copybash scripts/sonarr.sh config