radarr

Search and add movies to Radarr. Supports collections, search-on-add option.

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

When & Why to Use This Skill

This Claude skill provides a powerful interface for managing your Radarr media library, enabling users to search for movies, add them with collection support, and manage library contents through simple natural language commands. It streamlines media acquisition by integrating TMDB metadata and automating the search-on-add process for a seamless home theater management experience.

Use Cases

  • Instant Movie Discovery: Search for movies by title and receive detailed results with clickable TMDB links to verify metadata before adding.
  • Franchise Management: Automatically identify if a movie is part of a collection and prompt to add the entire series to your library in one step.
  • Library Auditing: Quickly check if specific titles already exist in your Radarr database to prevent duplicates and manage storage efficiently.
  • Remote Library Maintenance: Remove unwanted movies from your collection with the option to simultaneously delete local files via conversational commands.
  • Automated Quality Control: Configure and override default quality profiles and root folders dynamically when adding new media content.
nameradarr
version1.0.1
descriptionSearch and add movies to Radarr. Supports collections, search-on-add option.
metadata{"clawdbot":{"emoji":"🎬","requires":{"bins":["curl","jq"]}}}

Radarr

Add movies to your Radarr library with collection support.

Setup

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

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

Workflow

  1. Search: search "Movie Name" - returns numbered list
  2. Present results with TMDB links - always show clickable links
  3. Check: User picks a number
  4. Collection prompt: If movie is part of collection, ask user
  5. Add: Add movie or full collection

Important

  • Always include TMDB links when presenting search results to user
  • Format: [Title (Year)](https://themoviedb.org/movie/ID)
  • Uses defaultQualityProfile from config; can override per-add

Commands

Search for movies

bash scripts/radarr.sh search "Inception"

Check if movie exists in library

bash scripts/radarr.sh exists <tmdbId>

Add a movie (searches immediately by default)

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

Add full collection (searches immediately by default)

bash scripts/radarr.sh add-collection <collectionTmdbId>
bash scripts/radarr.sh add-collection <collectionTmdbId> --no-search

Remove a movie

bash scripts/radarr.sh remove <tmdbId>              # keep files
bash scripts/radarr.sh remove <tmdbId> --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/radarr.sh config