apple-music

What This Skill Does

The apple-music skill provides OpenClaw with deep integration into the Apple Music ecosystem, leveraging either native AppleScript on macOS or the official MusicKit API for broader interaction. It bridges the gap between your AI agent and your personal music library, enabling control over playback, organization of playlists, and access to rich track metadata. By utilizing this skill, the agent gains the ability to act as a sophisticated music concierge, managing your listening experience directly from your terminal or AI environment.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/epheterson/mcp-applemusic Ensure you have the Music application installed and running if you intend to use the AppleScript features for local control. For MusicKit API functionality, ensure you have your developer tokens ready.

Use Cases

• Playlist Management: Automatically curate and organize your music library by creating new playlists and moving tracks between them.
• Playback Automation: Use voice or text commands to skip tracks, adjust volume, or pause playback when you need to focus.
• Library Auditing: Query your library to find specific tracks, albums, or genres without manually scrolling through the interface.
• Smart Interactivity: Leverage the agent to find the current track details, artist information, and release years while you listen.

Example Prompts

• "OpenClaw, create a new playlist called 'Focus Beats' and add the last three songs I listened to."
• "What is the current track playing and which album does it belong to?"
• "Find all songs in my library by The Beatles and add them to my 'Classics' playlist."

Tips & Limitations

The most critical limitation to remember is the Library-First workflow. Because Apple Music differentiates between catalog IDs (content you don't own) and library IDs (content you have added to your collection), you cannot add a catalog search result directly to a playlist. You must first ensure the song exists in your user library (i.abc123) before performing operations like adding it to a playlist. AppleScript provides superior local control for playback and current track metadata, while MusicKit API is better suited for cross-platform catalog searching. Always verify your authentication tokens if using the API approach to ensure consistent connectivity.