sonarr
Search and add TV shows to Sonarr. Supports monitor options, search-on-add.
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.
| 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:
{
"url": "http://localhost:8989",
"apiKey": "your-api-key",
"defaultQualityProfile": 1
}
defaultQualityProfile: Quality profile ID (runconfigto see options)
Workflow
- Search:
search "Show Name"- returns numbered list - Present results with TVDB links - always show clickable links
- Check: User picks a number
- 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
defaultQualityProfilefrom 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