Skip to content

Releases

v0.9.3

Choose a tag to compare

@jamiew jamiew released this 07 Nov 18:18

Cancelled or stalled calls now stop waiting for a Spotify token, too.

  • Token fetches and refreshes honor cancellation and the 15-second deadline, and a refresh that lands late is still saved 9e753a2

v0.9.2

Choose a tag to compare

@jamiew jamiew released this 07 Nov 17:57

The local stdio server starts and lists tools without a client ID or login.

  • Tool calls without setup say to set SPOTIFY_CLIENT_ID and run pnpm run login, instead of the server exiting at startup 13c7f42

v0.9.1

Choose a tag to compare

@jamiew jamiew released this 07 Nov 17:52

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:meta lists tools through the SDK, and the MCP client moves to dev dependencies 2b16c06

v0.9.0

Choose a tag to compare

@jamiew jamiew released this 07 Nov 17:38

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.json entry, tested over stdio on both protocol eras 0dd0554
  • Dependencies updated and security alerts fixed PR #21

0.8.0

Choose a tag to compare

@jamiew jamiew released this 02 Nov 00:31
28696fd

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_episodes with resume points, and save/remove for each. check_library takes shows, episodes and audiobooks too.
  • Playback state and the queue describe a playing podcast episode. add_to_queue keeps episode links.
  • Playback controls and add_to_queue no longer report an error after Spotify did the action (#17).
  • Rejected requests (400s) show Spotify's reason and no longer say "try again shortly".
  • agents 0.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

Choose a tag to compare

@jamiew jamiew released this 01 Nov 20:26
3f3e0a1
  • get_playlist no longer fails on a playlist that holds a podcast episode. It now asks Spotify for episodes and lists them with type: "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

Choose a tag to compare

@jamiew jamiew released this 01 Nov 19:56
923006f
  • Fix playlists, playback and the queue failing on local files.
  • Fix control_playback play 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

Choose a tag to compare

@jamiew jamiew released this 20 Sep 18:58
  • 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

Choose a tag to compare

@jamiew jamiew released this 17 Sep 20:06

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_artist and get_album take 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_album replace the *_details names, so one set of names covers both servers.
  • Playlist positions stay aligned: removed, region-locked and local rows come back as Unavailable in place, so reorder_playlist and remove_tracks_from_playlist act on the right rows.
  • Library writes fixed for restricted apps: /me/library takes 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: agents 0.23, MCP SDK 1.30, workers-oauth-provider 0.10 (S256 PKCE required for public clients), hono 4.13; audit clean at every level
  • the tool surface lives in src/tools.ts and is tested in-process over an MCP transport (63 tests, up from 42); the inherited 690-line OAuth utils became a 264-line src/consent.ts
  • server icon served as https URLs and real favicon bytes, so clients actually show it

17 commits since v0.4.0

v0.4.0 — Cover Story

Choose a tag to compare

@jamiew jamiew released this 30 Jul 19:25

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_cover replaces a playlist's artwork. It takes an https URL 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, and follow_playlist — which had been missing opposite unfollow_playlist since 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_playlist gained the /me/library fallback 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.json said 0.2.0 while the server reported 0.3.0 to clients. Both are 0.4.0, and check:meta now fails if they drift.
  • Removed savedTracksContain, implemented but never registered as a tool.
  • PLAN.md records the API surface deliberately left out — podcasts, audiobooks and chapters, the contains family, 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.

3 commits since dbb6931