Repository navigation
Releases
v0.9.3
v0.9.2
v0.9.1
Cancelled tool calls now stop their Spotify requests, and cover uploads stop reading once an image is too big.
- Cancelling a call aborts its in-flight Spotify request and any retry wait, and each attempt times out after 15 seconds de2a2c0
- Cover uploads check
Content-Length, stream the image and stop at 192 KB under a deadline de2a2c0 check:metalists tools through the SDK, and the MCP client moves to dev dependencies 2b16c06
v0.9.0
Moves to MCP SDK v2 on a stateless Worker, which serves both protocol eras at less than half the bundle size.
- MCP SDK v2, a stateless Worker, and Spotify tokens owned by the OAuth grant PR #23
- Library writes share one code path, and the approval form stops echoing internal errors b5f2fff
- A
spotify-local.mcp.jsonentry, tested over stdio on both protocol eras 0dd0554 - Dependencies updated and security alerts fixed PR #21
0.8.0
Reconnect once after upgrading. The server now asks for user-read-playback-position so episode lists include resume points.
- New podcast and audiobook tools: saved shows, episodes and audiobooks,
get_show_episodeswith resume points, and save/remove for each.check_librarytakes shows, episodes and audiobooks too. - Playback state and the queue describe a playing podcast episode.
add_to_queuekeeps episode links. - Playback controls and
add_to_queueno longer report an error after Spotify did the action (#17). - Rejected requests (400s) show Spotify's reason and no longer say "try again shortly".
agents0.32 and vitest 5.
Checked live after deploy: every playback control, the new save/check/remove round trips for shows, episodes and audiobooks, and an episode queued while a show played.
0.7.2
get_playlistno longer fails on a playlist that holds a podcast episode. It now asks Spotify for episodes and lists them withtype: "episode"and the podcast name as the artist (#14).
Checked live after deploy: all 87 of my playlists load, including the one with a podcast episode.
Local file and playback fixes
- Fix playlists, playback and the queue failing on local files.
- Fix
control_playbackplay sending both a context and track URIs, and accept share links as the context. - Report a playing podcast episode or ad instead of "No active playback."
- Correct the cover art size limit in the docs (192 KB JPEG).
- Update dependencies and clear the dependency audit.
@jamiew: please do an authenticated live check on the deployed Worker, for example get_playback_state and get_playlist on a playlist with a local file.
Local login and safer playlist edits
- Run all 34 tools locally or on Cloudflare.
- Add typed results, search offsets, and safer playlist edits.
- Fix login, OAuth errors, and playlist-removal confirmations.
- Shorten setup docs and add a new header.
v0.6.1 — In Sync
Batch reads, a library membership check, and the tool names shared with the Python sibling. Also fixes a silent deploy outage and a library-write bug that a restricted Spotify app would have hit outright.
Highlights
- Batch reads:
get_tracks,get_artistandget_albumtake up to 50 IDs (20 for albums) in one request, falling back to one request per ID if Spotify withholds the batch route. check_library: whether tracks or albums are saved and artists followed, up to 40 IDs per call, instead of paging the whole library before a bulk save.- Names shared with spotify-mcp 0.6.1:
get_tracks,get_artist,get_albumreplace the*_detailsnames, so one set of names covers both servers. - Playlist positions stay aligned: removed, region-locked and local rows come back as
Unavailablein place, soreorder_playlistandremove_tracks_from_playlistact on the right rows. - Library writes fixed for restricted apps:
/me/librarytakes its URIs as a query parameter; the JSON body we sent was rejected with 400 and only worked here via the legacy fallback.
Also in this release
- share links (
open.spotify.com/...) accepted wherever an ID or URI is - deploys had silently stopped after 0.4.0: the dependency audit went red on transitive advisories and the deploy job depends on it; fixed, so the icon fix from August is finally live
- dependencies current:
agents0.23, MCP SDK 1.30,workers-oauth-provider0.10 (S256 PKCE required for public clients),hono4.13; audit clean at every level - the tool surface lives in
src/tools.tsand is tested in-process over an MCP transport (63 tests, up from 42); the inherited 690-line OAuth utils became a 264-linesrc/consent.ts - server icon served as
httpsURLs and real favicon bytes, so clients actually show it
v0.4.0 — Cover Story
Nine new tools covering playlist cover art, following, saved albums and artist discographies — plus a fix for an auth bug that made every one of them unreachable.
Highlights
- Playlist cover art:
set_playlist_coverreplaces a playlist's artwork. It takes anhttpsURL rather than image data, because Spotify wants base64-encoded JPEG in the request body and 256 KB of that is roughly 340,000 characters — not something a model can pass as a tool argument. The Worker fetches, checks the type, encodes and enforces the cap. - Following:
get_followed_artists,follow_artists,unfollow_artists, andfollow_playlist— which had been missing oppositeunfollow_playlistsince the first release. - Saved albums:
get_saved_albums,save_albums,remove_saved_albums. The library previously covered tracks only. - Artist discography:
get_artist_albums, filterable by album, single, compilation or guest appearance. Spotify withdrew artist top-tracks from third-party apps, so this is the only way left to walk a catalog. - Scope upgrades now take effect: the agent seeded its Spotify token once and refreshed that grant forever, so re-authorizing after a scope change did nothing — a refresh only ever returns the scopes the original token was minted with. It now records the granted scopes and adopts a fresh grant when they differ.
Also in this release
unfollow_playlistgained the/me/libraryfallback the other library writes already had, so it survives a flip to Spotify's restricted regime.- A 403 caused by a missing scope now says to reconnect and re-authorize, instead of the generic "the account may lack access".
package.jsonsaid0.2.0while the server reported0.3.0to clients. Both are0.4.0, andcheck:metanow fails if they drift.- Removed
savedTracksContain, implemented but never registered as a tool. PLAN.mdrecords the API surface deliberately left out — podcasts, audiobooks and chapters, thecontainsfamily, following users, reading playlist images — each with the reason, plus which tools are most at risk if this app is moved to Spotify's restricted regime.
All 33 tools were verified against the deployed Worker with live MCP calls, not just the test suite.