Spotify Notes Plugin
codyhxyz/spotify-notes-plugin
Anotações privadas sincronizadas com sua reprodução no Spotify em tempo real
Ver no GitHubSkill para Claude Code que captura notas com timestamp sobre a música que você está ouvindo no Spotify, direto do terminal, sem autenticação ou troca de contexto. Organiza automaticamente as anotações em arquivos markdown por faixa, permitindo recall instantâneo e busca entre anos de escuta.
Instalação
npx convez-ai codyhxyz/spotify-notes-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Capturar insights musicais sem abandonar o fluxo de trabalho
- Manter um diário pessoal de observações sobre músicas e produção
- Pesquisar e recuperar notas antigas sobre faixas específicas ou temas
Veredito

Solução criativa que elimina atrito real — zero configuração, zero auth, integração direta com app nativo. Implementação elegante usando IPC do Spotify. Recomendado para quem quer capturar pensamentos de forma rápida sem deixar o terminal.
README
A tradução para o português deste README ainda está na fila.
spotify-notes
A Claude Code plugin for keeping a private journal on whatever Spotify is playing, from inside your terminal, with no auth dance.
Before → After
Before. You hear a moment in a song. You know the thought will be gone in forty seconds. You swipe out of Spotify, open Notes, fumble the song title, type a half-sentence, swipe back, already can't remember what you noticed.
After. In whatever Claude Code session you already have open, you say note: that piano intro keeps refusing the downbeat. The plugin reads what Spotify is playing right now, appends the thought with a timestamp to a per-track markdown file, and hands control back. Zero context switch.
What you walk away with
- A growing folder of markdown files, one per track you've cared enough about to annotate — each with a clean running log of your thoughts
- Instant recall: "what did I write about this song" pulls the file for whatever's playing right now
- Search across years of listening: "find notes mentioning piano" greps the whole archive in one shot
- No Spotify API keys, no OAuth, no cloud — the plugin uses the desktop app's own IPC (AppleScript on macOS,
playerctlon Linux)
Install
/plugin marketplace add codyhxyz/codyhxyz-plugins
/plugin install spotify-notes@codyhxyz-plugins
Or directly from this repo:
/plugin marketplace add codyhxyz/spotify-notes-plugin
/plugin install spotify-notes@spotify-notes
Usage
Open any Claude Code session with the Spotify desktop app running. Say any of:
| You type | What happens |
|---|---|
note: that piano at 2:14 is killing me | Appends the note to <current-track>.md with a timestamp |
take a note about this song | Asks what you'd like to jot, then saves it |
what did I write about this song? | Reads the current track's file and shows all your notes |
what songs have I taken notes on? | Lists your annotated tracks, newest first |
find my notes about piano | Greps every saved note for "piano" and shows matches |
Notes live at ${CLAUDE_PLUGIN_DATA}/notes/<track-id>.md. Each file is plain markdown you can open in any editor.
Examples
Example 1 — quick capture.
You: note: marcus is in the low part of his voice, tired, not preaching yet
Claude: Saved to After the Storm — Mumford & Sons.
A new file at notes/4cOdK2wGLETKBW3PvgPWqT.md now contains frontmatter + a timestamped H2 section with your note. Next note on the same track appends below the first. Switch to a different song and the next note: lands in a different file.
Example 2 — recall.
You: what have I written about this one?
Claude: (reads
notes/4cOdK2wGLETKBW3PvgPWqT.mdand renders your prior H2 sections in order)
Example 3 — cross-song search.
You: find my notes about piano
Claude:
After the Storm — Mumford & Sons > held-breath piano keeps refusing the downbeat Jesus, Etc. — Wilco > piano like rain, endless
How the song detection works
- macOS: a one-liner AppleScript against the Spotify desktop app —
tell application "Spotify" to get .... Works whether Spotify is focused or backgrounded. No permissions prompt beyond the first time you run it. - Linux:
playerctl --player=spotify metadata ...over MPRIS. Requiresplayerctlinstalled (apt install playerctl/brew install playerctlon Mac if you prefer it there too). - Windows: not yet supported. Track detection via the native Spotify app on Windows is uglier (no MPRIS); PRs welcome.
If Spotify isn't running or isn't playing anything, the plugin tells you and stops. It will never silently invent a track name.
Why this exists
There's already a web app for this same idea. It works great but it forces a browser context switch, and it's gated on Spotify Premium (for the playback controls) and an OAuth session. This plugin is the terminal-native version: same goal (a song-indexed journal), none of the auth ceremony. Drop a thought while you're still in the middle of whatever else you were doing.
The plugin will not ever add:
- Spotify Web API calls (no tokens to manage = no tokens to leak)
- Cloud sync (your thoughts are your thoughts; git the folder if you want history)
- Playback controls (that's what Spotify already does)
Development
# From inside the plugin dir:
claude --plugin-dir .
# Then in the Claude Code session:
/plugin-reload
Validate before shipping:
claude plugin validate .
License
MIT — see LICENSE.