How do I install the Lidarr CLI skill?

Run npx skillmds@latest add theheavenlyd3mon/lidarr-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Lidarr CLI safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lidarr CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Lidarr CLI free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Lidarr CLI?

theheavenlyd3mon (@theheavenlyd3mon) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Lidarr CLI by theheavenlyd3mon — Agent Skill

Name: Lidarr CLI
Rating: 4.2 (5 reviews)
Author: theheavenlyd3mon

Lidarr CLI

Manage your Lidarr music library from the terminal. Search and browse artists and albums, add new artists, check calendars, view queue and download history, inspect quality and metadata profiles, and trigger searches. Use when the user mentions Lidarr, music management, adding an artist, searching for music, checking the music library, upcoming album releases, or download queue.

theheavenlyd3mon Updated Aug 19, 2026 28 repo stars

File contents

lidarr-cli — Lidarr Music Library Management

CLI for Lidarr music management. Part of the *arr family — shares the same API patterns as radarr-cli and sonarr-cli.

Quick Setup

export ARR_SERVER_LIDARR="http://localhost:8686"
export ARR_KEY_LIDARR="your-lidarr-api-key"

--help and --dry-run work without credentials.

When to Use Which

User says...	Load...
"list my artists", "what's in Lidarr", "show my music library"	`lidarr-cli artists [--limit N]`
"add this artist", "find an artist"	`lidarr-cli lookup --term "name"` then `lidarr-cli add --mb-id UUID --root /music`
"what albums does this artist have"	`lidarr-cli albums --artist-id N`
"show me the tracks"	`lidarr-cli tracks --album-id N`
"what's coming up", "upcoming albums"	`lidarr-cli calendar`
"what's in the queue", "download progress"	`lidarr-cli queue`
"show me history", "what was downloaded"	`lidarr-cli history`
"what's missing", "wanted albums"	`lidarr-cli wanted`
"check quality profiles"	`lidarr-cli quality-profile`
"check metadata profiles"	`lidarr-cli metadata-profile`
"storage space", "disk usage"	`lidarr-cli disk-space`
"search for an artist" (already added)	`lidarr-cli search --artist-id N`

Quick Reference

Global flags: --json, --dry-run, --force, --quiet, --verbose

# System info
lidarr-cli status

# Discover and add an artist (use MusicBrainz ID, not title)
lidarr-cli lookup --term "Radiohead"
lidarr-cli add --mb-id a74b1b7f-71a5-4011-9441-d0b5e4122711 --root /music --quality-profile 4 --search

# Browse content
lidarr-cli albums --artist-id 1
lidarr-cli tracks --album-id 1
lidarr-cli track-files --album-id 1

# Preview before adding
lidarr-cli --dry-run add --mb-id a74b1b7f-71a5-4011-9441-d0b5e4122711 --root /music

# Queue, history, wanted
lidarr-cli queue --limit 10
lidarr-cli wanted --limit 10
lidarr-cli history --limit 5

# Profiles and storage
lidarr-cli quality-profile           # list all
lidarr-cli quality-profile 4         # inspect specific
lidarr-cli metadata-profile          # list metadata profiles
lidarr-cli disk-space                # storage usage
lidarr-cli health                    # health warnings

Artist lookup by MusicBrainz ID (MBID): Lidarr uses MusicBrainz IDs (UUID format, e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711) instead of TMDb/TVDb integer IDs.

Default quality profile: 4. Default metadata profile: 1.

Reference Files

File	Contents
`references/lidarr-commands.md`	Full command reference with all flags and examples
`references/troubleshooting.md`	Pitfalls, FAQs, and when NOT to use

When NOT to Use

Music playback — use Jellyfin for listening. This CLI only manages the library.
First-time Lidarr setup — assumes Lidarr is already installed and configured.
Bulk imports — use Lidarr's built-in import features for large migrations.

---name: lidarr-clidescription: Manage your Lidarr music library from the terminal. Search and browse artists and albums, add new artists, check calendars, view queue and download history, inspect quality and metadata profiles, and trigger searches. Use when the user mentions Lidarr, music management, adding an artist, searching for music, checking the music library, upcoming album releases, or download queue.license: MIT---# lidarr-cli — Lidarr Music Library ManagementCLI for Lidarr music management. Part of the *arr family — shares the sameAPI patterns as radarr-cli and sonarr-cli.## Quick Setup```bashexport ARR_SERVER_LIDARR="http://localhost:8686"export ARR_KEY_LIDARR="your-lidarr-api-key"````--help` and `--dry-run` work without credentials.## When to Use Which| User says... | Load... ||---|---|| "list my artists", "what's in Lidarr", "show my music library" | `lidarr-cli artists [--limit N]` || "add this artist", "find an artist" | `lidarr-cli lookup --term "name"` then `lidarr-cli add --mb-id UUID --root /music` || "what albums does this artist have" | `lidarr-cli albums --artist-id N` || "show me the tracks" | `lidarr-cli tracks --album-id N` || "what's coming up", "upcoming albums" | `lidarr-cli calendar` || "what's in the queue", "download progress" | `lidarr-cli queue` || "show me history", "what was downloaded" | `lidarr-cli history` || "what's missing", "wanted albums" | `lidarr-cli wanted` || "check quality profiles" | `lidarr-cli quality-profile` || "check metadata profiles" | `lidarr-cli metadata-profile` || "storage space", "disk usage" | `lidarr-cli disk-space` || "search for an artist" (already added) | `lidarr-cli search --artist-id N` |## Quick Reference**Global flags:** `--json`, `--dry-run`, `--force`, `--quiet`, `--verbose````bash# System infolidarr-cli status# Discover and add an artist (use MusicBrainz ID, not title)lidarr-cli lookup --term "Radiohead"lidarr-cli add --mb-id a74b1b7f-71a5-4011-9441-d0b5e4122711 --root /music --quality-profile 4 --search# Browse contentlidarr-cli albums --artist-id 1lidarr-cli tracks --album-id 1lidarr-cli track-files --album-id 1# Preview before addinglidarr-cli --dry-run add --mb-id a74b1b7f-71a5-4011-9441-d0b5e4122711 --root /music# Queue, history, wantedlidarr-cli queue --limit 10lidarr-cli wanted --limit 10lidarr-cli history --limit 5# Profiles and storagelidarr-cli quality-profile # list alllidarr-cli quality-profile 4 # inspect specificlidarr-cli metadata-profile # list metadata profileslidarr-cli disk-space # storage usagelidarr-cli health # health warnings```**Artist lookup by MusicBrainz ID (MBID):** Lidarr uses MusicBrainz IDs (UUID format,e.g. `a74b1b7f-71a5-4011-9441-d0b5e4122711`) instead of TMDb/TVDb integer IDs.**Default quality profile:** 4. **Default metadata profile:** 1.## Reference Files| File | Contents ||------|----------|| `references/lidarr-commands.md` | Full command reference with all flags and examples || `references/troubleshooting.md` | Pitfalls, FAQs, and when NOT to use |## When NOT to Use- **Music playback** — use Jellyfin for listening. This CLI only manages the library.- **First-time Lidarr setup** — assumes Lidarr is already installed and configured.- **Bulk imports** — use Lidarr's built-in import features for large migrations.

Frequently asked questions