What this skill does
Access Spotify listening history, top artists/tracks, and get personalized recommendations via the Spotify Web API. Use when fetching a user's recent plays, analyzing music taste, or generating recommendations. Requires one-time OAuth setup.
Spotify History is part of the Data & APIs category — data and API skills that fetch, query, and work with external data sources. You can install it on its own or alongside other data & apis skills from the OpenClaw catalog.
How to install Spotify History
The easiest path is via the OpenClaw Easy desktop app — one click, no terminal required:
- Download OpenClaw Easy for macOS or Windows (free, one-click installer, ~30 seconds).
- Open the in-app Skills panel.
- Search for
spotify-historyand click Install. - The skill activates automatically when an incoming message matches its description.
Install from the command line
If you already run the OpenClaw CLI, add Spotify History with a single command:
openclaw skills add spotify-history
This pulls spotify-history from ClawHub and installs it into ~/.openclaw/skills/spotify-history/. Restart the OpenClaw gateway afterwards so the new skill is discovered.
How to use Spotify History
Once installed, Spotify History activates on its own: when an incoming message on WhatsApp, Telegram, Slack, Discord, Feishu or Line matches the skill's description, your OpenClaw agent loads it and runs the workflow. You can also trigger it explicitly by describing the task in chat. No extra configuration is required after install.
Putting audio in front of an audience
Spotify History works with audio. Getting from there to something postable is a separate job: ViralMint — an open-source video pipeline — pairs audio with footage or generated visuals, burns synced captions, and exports a finished short.
It runs as an MCP server, so an OpenClaw agent can drive it from the same chat you already use: ask for a short, and the render comes back finished. See how to connect a video pipeline to your agent.
Manual install (advanced)
If you prefer manual installation:
- Click the Download .zip button above to grab
spotify-history-1.1.0.zipdirectly from our S3 mirror. - Unzip into
~/.openclaw/skills/spotify-history/(create the directory if it does not exist). - Restart OpenClaw Easy (or the OpenClaw CLI gateway) so the new skill is discovered.
Frequently asked questions
How do I install Spotify History?
Install Spotify History in the OpenClaw Easy desktop app by opening the Skills panel, searching for spotify-history, and clicking Install. From a terminal you can run: openclaw skills add spotify-history. Either way the skill is placed in ~/.openclaw/skills/spotify-history/.
Is Spotify History free?
Yes. Spotify History is free and open-source, distributed under the Apache-2.0 license through ClawHub. No account or payment is required to download or run it.
What does Spotify History do?
Access Spotify listening history, top artists/tracks, and get personalized recommendations via the Spotify Web API. Use when fetching a user's recent plays, analyzing music taste, or generating recommendations. Requires one-time OAuth setup.
Related: more data & apis skills
If Spotify History looks useful, you may also want to check out other data & apis skills in the OpenClaw catalog:
Browse the full OpenClaw skill catalog
This page covers just one skill. The OpenClaw skill hub has 10,000+ more — search, sort by downloads or stars, and install any of them in one click. There is also a curated awesome-openclaw-skills list grouped by use case.
Get OpenClaw Easy — Free
Install Spotify History and 10,000+ other OpenClaw skills in one click. Free, open-source, runs locally on macOS & Windows.
Free, open-source · Apache-2.0 · Works with Claude, ChatGPT, Gemini, or local Ollama models