spotify-applescript

What This Skill Does

The spotify-applescript skill provides a native, low-latency interface for controlling the Spotify desktop application on macOS. By leveraging AppleScript hooks, this skill bypasses the need for complex OAuth authentication, API rate limiting, or developer tokens. It acts as an abstraction layer over Spotify's internal scripting dictionary, allowing OpenClaw to perform common playback tasks—such as switching playlists, adjusting volume, or fetching track metadata—directly on your local machine. Because it communicates via local system messages rather than cloud-based APIs, it offers near-instantaneous response times and works even when the computer is offline.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/andrewjiang/spotify-applescript

Ensure that the Spotify desktop application is installed on your macOS system and that it is active. No additional configuration, API keys, or environment variables are required for deployment.

Use Cases

This skill is ideal for users who want to bridge the gap between AI-driven task management and their local media environment. Common use cases include setting up a "deep work" environment where the AI automatically queues a focus playlist, adjusting volume during conference calls without switching apps, or querying current track information for automated logging or social sharing. It is particularly useful for users who find graphical interfaces distracting and prefer text-based control over their local audio playback.

Example Prompts

1. "Spotify, start playing my morning jazz playlist and set the volume to 30 percent."
2. "What track is currently playing in Spotify?"
3. "Pause the music and mute Spotify, I need to take a quick phone call."

Tips & Limitations

• Performance: Because this relies on AppleScript, the Spotify app must be open and running. If it is closed, the skill will be unable to initialize playback.
• URI Support: For best results, use standard Spotify URIs (spotify:track:...) rather than long URLs, though the script handles link conversion automatically.
• Scope: This tool only manages the local desktop application. It cannot control Spotify on other devices, such as mobile phones or smart speakers, even if they are linked via the same account. If you need to switch playback devices, you will need to do so manually through the Spotify UI.