apple_music
Control Apple Music playback, playlists, and search. Perform actions like play, pause, skip, shuffle, set volume, and more.
Instructions
Control Apple Music. Actions: play, pause, stop, next, prev, restart, now_playing, shuffle_on, shuffle_off, repeat_off, repeat_one, repeat_all, play_playlist, list_playlists, set_volume, love, dislike, search, play_song, queue_next, add_to_playlist, remove_from_playlist, create_playlist, delete_playlist, get_lyrics, radio.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Playlist name | |
| level | No | Volume level 0-100 | |
| query | No | Search query (song or artist name) | |
| action | Yes | play: Start playback; pause: Pause playback; stop: Stop playback; next: Skip to next track; prev: Go to previous track; restart: Restart current track from the beginning; now_playing: Get info about the currently playing track; shuffle_on: Enable shuffle mode; shuffle_off: Disable shuffle mode; repeat_off: Disable repeat; repeat_one: Repeat current track; repeat_all: Repeat all tracks; play_playlist: Play a specific playlist by name; list_playlists: List all playlists; set_volume: Set Music app volume (independent of system volume); love: Mark the current track as loved; dislike: Mark the current track as disliked; search: Search Music library by song or artist name (returns up to 20 results); play_song: Play a specific song by name; queue_next: Add a song to play next. Note: Music has limited queue support via AppleScript, so this will start playing the track immediately.; add_to_playlist: Add the currently playing track to a playlist; remove_from_playlist: Remove a track from a playlist by name; create_playlist: Create a new empty playlist; delete_playlist: Delete a playlist by name; get_lyrics: Get lyrics of the currently playing track (if available); radio: Open Apple Music radio. Note: AppleScript has limited support for radio stations; this activates the Music app. | |
| confirm | No | Set to true to confirm a protected/destructive action. Without this, protected actions return a preview instead of executing. | |
| track_name | No | Track name to remove | |
| playlist_name | No | Target playlist name |