# Sonarr

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

- Skill: `modbender/sonarr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/sonarr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/sonarr/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/sonarr

---


# Sonarr

Add TV shows to your Sonarr library.

## Setup

Create `~/.clawdbot/credentials/sonarr/config.json`:
```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
bash scripts/sonarr.sh search "Breaking Bad"
```

### Check if show exists in library
```bash
bash scripts/sonarr.sh exists <tvdbId>
```

### Add a show (searches immediately by default)
```bash
bash scripts/sonarr.sh add <tvdbId>              # searches right away
bash scripts/sonarr.sh add <tvdbId> --no-search  # don't search
```

### Remove a show
```bash
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
bash scripts/sonarr.sh config
```