- “What’s on my iPod, and how full is it?”
- “Put all my Weezer on the iPod.”
- “Sync my road-trip playlist to the iPod, then eject it.”
add_artist_to_ipod
Push every track by an artist to the iPod’s library, no playlist artifact.
string
required
Artist name (exact match, case-sensitive).
add_tracks_to_ipod
Push specific tracks to the iPod’s library WITHOUT creating a playlist on the device. Tracks land in the main library and are browsable by artist/album.
string[]
required
Absolute paths (from the indexed library) of tracks to add. Use list_tracks_by_album / search_tracks to get paths. Never invent them.
eject_ipod
Safely unmount the iPod via diskutil eject. Idempotent: if the iPod is already unmounted, returns {"ejected": False, "already_unmounted": True} instead of raising. Classic iPods often auto-disconnect after a sync, so it may already be gone; that’s expected, so tell the user it’s safe to unplug.
get_ipod_contents
High-level snapshot of what’s on the iPod: capacity, used/free space, track/artist/album counts, and the top 25 artists by track count. Does NOT return the full track list. Use list_ipod_tracks to page through tracks (optionally filtered by artist).
list_ipod_playlists
List the playlists currently on the iPod (the ones visible under Music → Playlists on the device).
list_ipod_tracks
Paginated list of tracks on the iPod, optionally filtered by artist. Each track is the chat-friendly slice: artist, title, album, size in bytes. For the full per-track payload, use the CLI.
any
Optional artist filter (exact match). Omit to page through all tracks.
integer
default:"50"
Max tracks to return.
integer
Pagination offset (0 = first page).
remove_artist_from_ipod
Drop every track by an artist from the iPod, in one shot.
string
required
Artist name to drop from the iPod. Matched via canonical lead-artist rollup (album_artist-first), so e.g. removing ‘Taylor Swift’ also drops ‘Taylor Swift / HAIM’ tracks.
remove_ipod_playlist
Remove a playlist from the iPod (Music → Playlists). The playlist’s tracks are NOT deleted. They stay in the iPod’s main library, browsable by artist/album. Only the playlist artifact goes away.
string
required
Name of the iPod playlist to remove.
remove_tracks_from_ipod
Remove specific tracks from the iPod. Drops them from the iTunesDB AND deletes the underlying audio files from the device.
string[]
required
Absolute paths (from the indexed library) of tracks to remove from the iPod. Get these via list_tracks_by_album or search_tracks. Paths that aren’t on the iPod are reported back as unmatched, not an error.
sync_playlist_to_ipod
Push a saved playlist (the clickwheel-side draft) to the iPod AND create/update the corresponding playlist on the device under Music → Playlists. Copies any missing tracks first.
string
required
Saved playlist name to sync.
any
How to resolve a same-name playlist already on the iPod. Omit on the first call; if a conflict exists, this tool returns a structured error so you can ask the user to pick one of: ‘merge’ (combine tracks), ‘replace’ (overwrite contents), ‘rename’ (use target_name for a new playlist name).
any
Required when on_conflict=‘rename’. The new iPod-side playlist name to use instead of the clickwheel name.