Apple Music CLI

What it does

Apple Music CLI lets you control the Apple Music app on macOS directly from a terminal or through an AI assistant. It wraps AppleScript commands into a clean CLI and exposes the same functionality as an MCP server, so Claude and other MCP clients can manage your music playback, browse your library, and tweak settings without you leaving your workflow.

Tools

• play / pause / toggle — Start, stop, or toggle playback
• next / prev — Skip to the next or previous track
• now — Display current track title, artist, and album
• vol [level] — Get or set the volume (0–100)
• playlists — List all playlists in your library
• playlist [name] — Start playing a named playlist
• tracks [playlist] — List tracks in a given playlist
• songs — Browse all songs in your local library (supports --limit / --offset)
• search [query] — Search your local library by keyword
• song [name] — Play a specific track by name
• shuffle on/off — Toggle shuffle mode
• repeat off/one/all — Set repeat mode

Installation

Requires Bun and macOS with Apple Music.

git clone https://github.com/wiedymi/applemusic-cli
cd applemusic-cli
bun install

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "apple-music": {
      "command": "bun",
      "args": ["run", "/path/to/applemusic-cli/src/mcp/index.ts"]
    }
  }
}

Supported hosts

Claude Desktop (stdio, via Bun). macOS only — requires AppleScript access to the Music app.