> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickwheel.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Library

> clickwheel MCP server tools for Library.

**Try asking Claude**

* *"What's in my library?"*
* *"Do I have any Beastie Boys albums?"*
* *"Search my library for acoustic versions."*

## `library_health`

Setup probe: does the library directory exist, when was the last scan, how many indexed tracks are now missing from disk, is auto-scan enabled, etc.

## `library_stats`

High-level stats for the indexed music library.

## `list_albums_by_artist`

Albums for a single artist, ordered by year then album title. Each entry includes track count, total size in bytes, and the year (if known).

<ParamField path="artist" type="string" required>
  Artist name (exact match, case-sensitive).
</ParamField>

## `list_artists`

All artists in the indexed library, alphabetical, with track count, album count, and total size in bytes per artist. FLAC tracks are excluded (the iPod doesn't play FLAC).

<ParamField path="limit" type="integer" default="500">
  Max artists to return.
</ParamField>

## `list_tracks_by_album`

All tracks on one album, ordered by disc/track number. Returns full track records: title, path, duration, file size, format, year, etc.

<ParamField path="artist" type="string" required>
  Artist name (exact match).
</ParamField>

<ParamField path="album" type="string" required>
  Album title (exact match).
</ParamField>

## `search_tracks`

Case-insensitive substring search across artist, album, and title.

<ParamField path="query" type="string" required>
  Substring to match. Empty/whitespace returns \[].
</ParamField>

<ParamField path="limit" type="integer" default="50">
  Max results.
</ParamField>