> ## 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.

# Apple Music

> clickwheel MCP server tools for Apple Music.

**Try asking Claude**

* *"Push my road-trip playlist to Apple Music."*
* *"Pull my Heavy Rotation playlist from Apple Music."*

## `apple_music_health`

Probe the Apple Music integration end-to-end without changing anything.

## `delete_apple_music_playlist`

Delete a library playlist from the user's Apple Music account.

<ParamField path="name" type="string" required>
  Library playlist name to delete from Apple Music.
</ParamField>

## `list_apple_music_playlists`

List every library playlist in the user's Apple Music account.

## `pull_playlist_from_apple_music`

Import a library playlist from Apple Music into clickwheel.

<ParamField path="name" type="string" required>
  Apple Music library playlist name to import into clickwheel.
</ParamField>

<ParamField path="overwrite" type="boolean">
  Replace an existing clickwheel playlist with the same name. Without this, the operation refuses to clobber.
</ParamField>

<ParamField path="min_fuzzy_confidence" type="number" default="0.85">
  Threshold for the fuzzy-fallback match against the local library. Tracks below this score are reported as unmatched.
</ParamField>

## `sync_playlist_to_apple_music`

Create a playlist in the user's Apple Music account from a clickwheel playlist.

<ParamField path="playlist" type="string" required>
  Saved clickwheel playlist name to push to Apple Music.
</ParamField>

<ParamField path="refresh" type="boolean">
  Ignore the cached catalog matches and re-match every track. Useful after retagging files.
</ParamField>

<ParamField path="min_confidence" type="number" default="0.85">
  Confidence threshold (0.0–1.0). Tracks scoring below this are skipped unless `include_low_confidence=true`.
</ParamField>

<ParamField path="include_low_confidence" type="boolean">
  Push low-confidence matches anyway. Use only after a match preview confirms the candidates look right.
</ParamField>