Spotify MCP server for AI agents
Let Claude, ChatGPT or your own agent read Spotify: 35 typed functions through one MCP server. No Spotify API key needed.
- Site
- open.spotify.com
- Functions
- 35
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Spotify alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/spotifyOne MCP server for Spotify and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
browseCategoryBrowse a Spotify category's page (a genre or mood) as its sections of editorial playlists.Arguments
Name Type Required idstringYes Returns
SpotifyBrowseCategoryinterface SpotifyBrowseItem { kind: "playlist" | "album" | "artist" | "track" | "category" | "other"; id: string | null; uri: string; name: string; description: string | null; imageUrl: string | null; } interface SpotifyBrowseSection { title: string; items: SpotifyBrowseItem[]; } interface SpotifyBrowseCategory { categoryId: string; /** the category's own name, e.g. "Pop" */ title: string | null; sections: SpotifyBrowseSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/browseCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.browseCategory("0JQ5DAqbMKFEC4WFtoNRpw");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.browseCategory("0JQ5DAqbMKFEC4WFtoNRpw"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/browseCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"0JQ5DAqbMKFEC4WFtoNRpw"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.browseCategory("0JQ5DAqbMKFEC4WFtoNRpw");getAlbumGet details about a specific album.Arguments
Name Type Required idstringYes Returns
SpotifyAlbuminterface SpotifyAlbum { id: string; name: string; artists: { id: string; name: string }[]; release_date: string; total_tracks: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getAlbumCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getAlbum("2noRn2Aes5aoNVsU6iWThc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getAlbum("2noRn2Aes5aoNVsU6iWThc"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getAlbum \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"2noRn2Aes5aoNVsU6iWThc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getAlbum("2noRn2Aes5aoNVsU6iWThc");getArtistGet details about a specific artist.Arguments
Name Type Required idstringYes Returns
SpotifyArtistinterface SpotifyArtist { id: string; name: string; genres: string[]; popularity: number; followers: { total: number }; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getArtistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getArtist("4tZwfgrHOc3mvqYlEYSvVi");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getArtist("4tZwfgrHOc3mvqYlEYSvVi"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getArtist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"4tZwfgrHOc3mvqYlEYSvVi"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getArtist("4tZwfgrHOc3mvqYlEYSvVi");getAvailableMarketsList the two-letter country codes of every market Spotify is available in.Arguments
None.
Returns
SpotifyMarketsinterface SpotifyMarkets { markets: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getAvailableMarketsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getAvailableMarkets();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getAvailableMarkets())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getAvailableMarkets \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getAvailableMarkets();getChartGet Spotify's featured charts by type and country.Arguments
Name Type Required opts{ type?: SpotifyChartType }No export type SpotifyChartType = "tracks" | "albums" | "artists";Returns
SpotifyChartexport type SpotifyChartType = "tracks" | "albums" | "artists"; interface SpotifyChartEntry { rank: number; previousRank: number | null; peakRank: number | null; status: string | null; // "NO_CHANGE", the chart's own entryStatus labels; read the values off a result, never guess one from prose id: string | null; uri: string | null; name: string; artists: { id: string | null; name: string }[]; // empty for an artists chart imageUrl: string | null; } interface SpotifyChart { type: SpotifyChartType; title: string; date: string | null; recurrence: string | null; // WEEKLY country: string | null; // GLOBAL entries: SpotifyChartEntry[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getChartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getChart({ type: "tracks" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getChart({"type": "tracks"}))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getChart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"opts":{"type":"tracks"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getChart({ type: "tracks" });getCurrentPlaybackGet the signed-in user's current playback state.Arguments
None.
Returns
SpotifyCurrentPlaybackinterface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; } interface SpotifyCurrentPlayback { isPlaying: boolean; progressMs: number | null; item: SpotifyTrack | null; shuffleState: boolean; repeatState: string | null; device: { id: string | null; name: string; type: string } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getCurrentPlaybackCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getCurrentPlayback();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getCurrentPlayback())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getCurrentPlayback \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getCurrentPlayback();getDevicesGet the signed-in user's available devices.Arguments
None.
Returns
{ devices: SpotifyDevice[] }interface SpotifyDevice { id: string | null; isActive: boolean; isRestricted: boolean; name: string; type: string; volumePercent: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getDevicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getDevices();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getDevices())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getDevices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getDevices();getEpisodeGet details about a specific podcast episode.Arguments
Name Type Required idstringYes Returns
SpotifyEpisodeinterface SpotifyEpisode { id: string; name: string; description: string; releaseDate: string; durationMs: number; explicit: boolean; show?: { id: string; name: string }; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getEpisodeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getEpisode("512ojhOuo1ktJprKbVcKyQ");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getEpisode("512ojhOuo1ktJprKbVcKyQ"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getEpisode \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"512ojhOuo1ktJprKbVcKyQ"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getEpisode("512ojhOuo1ktJprKbVcKyQ");getFeaturedPlaylistsGet the featured shelves (trending, popular, radio and chart playlists) on Spotify's signed-out home page.Arguments
None.
Returns
SpotifyFeaturedinterface SpotifyBrowseItem { kind: "playlist" | "album" | "artist" | "track" | "category" | "other"; id: string | null; uri: string; name: string; description: string | null; imageUrl: string | null; } interface SpotifyBrowseSection { title: string; items: SpotifyBrowseItem[]; } interface SpotifyFeatured { sections: SpotifyBrowseSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getFeaturedPlaylistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getFeaturedPlaylists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getFeaturedPlaylists())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getFeaturedPlaylists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getFeaturedPlaylists();getGenreSeedsList the genre seed values Spotify's catalog recognizes.Arguments
None.
Returns
SpotifyGenreSeedsinterface SpotifyGenreSeeds { genres: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getGenreSeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getGenreSeeds();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getGenreSeeds())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getGenreSeeds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getGenreSeeds();getLibraryAlbumsGet the signed-in user's saved albums.Arguments
Name Type Required opts{ limit?: number; offset?: number }No Returns
{ albums: { addedAt: string | null; album: SpotifyAlbum }[]; total: number }interface SpotifyAlbum { id: string; name: string; artists: { id: string; name: string }[]; release_date: string; total_tracks: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getLibraryAlbumsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getLibraryAlbums();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getLibraryAlbums())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getLibraryAlbums \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getLibraryAlbums();getLibraryArtistsGet the signed-in user's followed artists.Arguments
Name Type Required opts{ limit?: number; after?: string }No Returns
{ artists: SpotifyArtist[]; total: number; after: string | null }interface SpotifyArtist { id: string; name: string; genres: string[]; popularity: number; followers: { total: number }; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getLibraryArtistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getLibraryArtists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getLibraryArtists())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getLibraryArtists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getLibraryArtists();getLibraryPlaylistsGet the signed-in user's playlists.Arguments
Name Type Required opts{ limit?: number; offset?: number }No Returns
{ playlists: SpotifyPlaylist[]; total: number }interface SpotifyPlaylist { id: string; name: string; description: string; owner: { id: string; display_name: string }; images: { url: string }[]; tracks: { total: number }; public: boolean; collaborative: boolean; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getLibraryPlaylistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getLibraryPlaylists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getLibraryPlaylists())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getLibraryPlaylists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getLibraryPlaylists();getLibraryTracksGet the signed-in user's saved tracks.Arguments
Name Type Required opts{ limit?: number; offset?: number }No Returns
{ tracks: { addedAt: string | null; track: SpotifyTrack }[]; total: number }interface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getLibraryTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getLibraryTracks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getLibraryTracks())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getLibraryTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getLibraryTracks();getLyricsA track's lyrics as Spotify's lyrics panel shows them, line by line (time-synced when available).Arguments
Name Type Required trackstringYes Returns
SpotifyLyricsinterface SpotifyLyrics { trackId: string; /** false when Spotify has no lyrics for this track */ available: boolean; syncType: string | null; // "LINE_SYNCED" | "UNSYNCED" … language: string | null; provider: string | null; // e.g. "Musixmatch" /** startTimeMs is null when the lyrics are not time-synced */ lines: { startTimeMs: number | null; words: string }[]; /** the lines joined with newlines */ text: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getLyricsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getLyrics("0DiWol3AO6WpXZgp0goxAV");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getLyrics("0DiWol3AO6WpXZgp0goxAV"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getLyrics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"track":"0DiWol3AO6WpXZgp0goxAV"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getLyrics("0DiWol3AO6WpXZgp0goxAV");getOEmbedGet oEmbed metadata (title, thumbnail, embeddable player) for a track, album, artist, playlist, episode or show.Arguments
Name Type Required inputstringYes typeSpotifyOEmbedTypeNo type SpotifyOEmbedType = "track" | "album" | "artist" | "playlist" | "episode" | "show";Returns
SpotifyOEmbedinterface SpotifyOEmbed { title: string; type: string; thumbnailUrl: string | null; html: string; iframeUrl: string | null; providerName: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getOEmbedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getOEmbed("0DiWol3AO6WpXZgp0goxAV", "track");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getOEmbed("0DiWol3AO6WpXZgp0goxAV", "track"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getOEmbed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":"0DiWol3AO6WpXZgp0goxAV","type":"track"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getOEmbed("0DiWol3AO6WpXZgp0goxAV", "track");getPlaylistGet details about a specific playlist.Arguments
Name Type Required idstringYes Returns
SpotifyPlaylistinterface SpotifyPlaylist { id: string; name: string; description: string; owner: { id: string; display_name: string }; images: { url: string }[]; tracks: { total: number }; public: boolean; collaborative: boolean; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getPlaylistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getPlaylist("37i9dQZF1DXaQ34lqGBfrU");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getPlaylist("37i9dQZF1DXaQ34lqGBfrU"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getPlaylist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"37i9dQZF1DXaQ34lqGBfrU"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getPlaylist("37i9dQZF1DXaQ34lqGBfrU");getPlaylistCoverImageGet a playlist's cover image urls, largest first.Arguments
Name Type Required idstringYes Returns
SpotifyPlaylistCoverinterface SpotifyPlaylistCover { playlistId: string; images: { url: string; height?: number; width?: number }[]; // largest first; [] when no cover }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getPlaylistCoverImageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getPlaylistCoverImage("37i9dQZF1DXaQ34lqGBfrU");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getPlaylistCoverImage("37i9dQZF1DXaQ34lqGBfrU"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getPlaylistCoverImage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"37i9dQZF1DXaQ34lqGBfrU"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getPlaylistCoverImage("37i9dQZF1DXaQ34lqGBfrU");getPodcastGet details about a specific podcast show.Arguments
Name Type Required idstringYes Returns
SpotifyShowinterface SpotifyShow { id: string; name: string; description: string; publisher: string; explicit: boolean; mediaType: string; totalEpisodes: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getPodcast("38bS44xjbVVZ3No3ByF1dJ");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getPodcast("38bS44xjbVVZ3No3ByF1dJ"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"38bS44xjbVVZ3No3ByF1dJ"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getPodcast("38bS44xjbVVZ3No3ByF1dJ");getRecentlyPlayedGet the signed-in user's recently played tracks.Arguments
Name Type Required opts{ limit?: number; before?: number; after?: number }No Returns
{ items: { playedAt: string; track: SpotifyTrack }[]; cursors: { before: string | null; after: string | null } }interface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getRecentlyPlayedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getRecentlyPlayed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getRecentlyPlayed())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getRecentlyPlayed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getRecentlyPlayed();getRecommendationsGet the tracks Spotify recommends for a seed track.Arguments
Name Type Required trackIdstringYes Returns
SpotifyRecommendationsinterface SpotifyRecommendations { seedTrackId: string; tracks: { id: string; uri: string; name: string; artists: { id: string; name: string }[]; album: { id: string } | null; durationMs: number | null; /** lifetime play count Spotify shows on the track */ playcount: number | null; imageUrl: string | null; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getRecommendationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getRecommendations("0DiWol3AO6WpXZgp0goxAV");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getRecommendations("0DiWol3AO6WpXZgp0goxAV"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getRecommendations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"trackId":"0DiWol3AO6WpXZgp0goxAV"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getRecommendations("0DiWol3AO6WpXZgp0goxAV");getRecommendationsByArtistGet what Spotify recommends alongside a seed artist: related artists, featuring playlists and appears-on releases.Arguments
Name Type Required artistIdstringYes Returns
SpotifyArtistRecommendationsinterface SpotifyArtistRecommendations { seedArtistId: string; relatedArtists: { id: string; uri: string; name: string; imageUrl: string | null }[]; featuringPlaylists: { id: string; uri: string; name: string; owner: string | null; imageUrl: string | null; }[]; appearsOn: { id: string; uri: string; name: string; type: string | null; year: number | null; artists: { id: string; name: string }[]; imageUrl: string | null; }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getRecommendationsByArtistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getRecommendationsByArtist("4tZwfgrHOc3mvqYlEYSvVi");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getRecommendationsByArtist("4tZwfgrHOc3mvqYlEYSvVi"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getRecommendationsByArtist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"artistId":"4tZwfgrHOc3mvqYlEYSvVi"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getRecommendationsByArtist("4tZwfgrHOc3mvqYlEYSvVi");getRelatedArtistsGet the artists Spotify lists as "Fans also like" for an artist.Arguments
Name Type Required idstringYes Returns
SpotifyRelatedArtistsinterface SpotifyRelatedArtists { artistId: string; /** how many related artists Spotify reports */ totalCount: number; artists: { id: string; uri: string; name: string; imageUrl: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getRelatedArtistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getRelatedArtists("4tZwfgrHOc3mvqYlEYSvVi");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getRelatedArtists("4tZwfgrHOc3mvqYlEYSvVi"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getRelatedArtists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"4tZwfgrHOc3mvqYlEYSvVi"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getRelatedArtists("4tZwfgrHOc3mvqYlEYSvVi");getTopArtistsGet the signed-in user's top artists.Arguments
Name Type Required timeRange"short_term" | "medium_term" | "long_term"Default "medium_term".No limitnumber1-50, default 20.No offsetnumberNo Returns
SpotifyTopArtistsinterface SpotifyArtist { id: string; name: string; genres: string[]; popularity: number; followers: { total: number }; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; } interface SpotifyTopArtists { artists: SpotifyArtist[]; total: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getTopArtistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getTopArtists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getTopArtists())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getTopArtists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getTopArtists();getTopTracksGet the signed-in user's top tracks.Arguments
Name Type Required timeRange"short_term" | "medium_term" | "long_term"Default "medium_term".No limitnumber1-50, default 20.No offsetnumberNo Returns
SpotifyTopTracksinterface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; } interface SpotifyTopTracks { tracks: SpotifyTrack[]; total: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getTopTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getTopTracks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getTopTracks())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getTopTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getTopTracks();getTrackGet details about a specific track including audio features.Arguments
Name Type Required idstringYes Returns
SpotifyTrackinterface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getTrackCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getTrack("0DiWol3AO6WpXZgp0goxAV");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getTrack("0DiWol3AO6WpXZgp0goxAV"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/getTrack \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"0DiWol3AO6WpXZgp0goxAV"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getTrack("0DiWol3AO6WpXZgp0goxAV");getUserProfileGet the signed-in user's profile information.Arguments
None.
Returns
SpotifyUserProfileinterface SpotifyUserProfile { id: string; displayName: string | null; country: string | null; product: string | null; // "premium" | "free" … followers: number; images: { url: string }[]; url: string; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/getUserProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.getUserProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.getUserProfile())curl -X POST https://api.bowmark.ai/v1/sites/spotify/getUserProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.getUserProfile();listAlbumTracksGet a page of an album's track listing.Arguments
Name Type Required idstringYes opts.limitnumber1-50, default 50.No opts.offsetnumberDefault 0.No Returns
SpotifyAlbumTracksResultinterface SpotifyAlbumTrack { id: string; name: string; artists: { id: string; name: string }[]; durationMs: number; explicit: boolean; trackNumber: number; external_urls: { spotify: string }; uri: string; } interface SpotifyAlbumTracksResult { albumId: string; tracks: SpotifyAlbumTrack[]; total: number; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/listAlbumTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.listAlbumTracks("2noRn2Aes5aoNVsU6iWThc");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.listAlbumTracks("2noRn2Aes5aoNVsU6iWThc"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/listAlbumTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"2noRn2Aes5aoNVsU6iWThc"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.listAlbumTracks("2noRn2Aes5aoNVsU6iWThc");listArtistAlbumsGet a page of an artist's discography.Arguments
Name Type Required idstringYes opts.includeGroups("album" | "single" | "compilation" | "appears_on")[]Default all four.No opts.limitnumber1-50, default 20.No opts.offsetnumberDefault 0.No opts.marketstringTwo-letter country, e.g. "US".No Returns
SpotifyPagedAlbumsinterface SpotifySimpleAlbum { id: string; name: string; albumType: string; artists: { id: string; name: string }[]; releaseDate: string; totalTracks: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; } interface SpotifyPagedAlbums { albums: SpotifySimpleAlbum[]; total: number; limit: number; offset: number; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/listArtistAlbumsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.listArtistAlbums("4tZwfgrHOc3mvqYlEYSvVi");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.listArtistAlbums("4tZwfgrHOc3mvqYlEYSvVi"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/listArtistAlbums \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"4tZwfgrHOc3mvqYlEYSvVi"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.listArtistAlbums("4tZwfgrHOc3mvqYlEYSvVi");listArtistTracksGet an artist's top tracks.Arguments
Name Type Required idstringYes marketstringNo Returns
SpotifyTrack[]interface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/listArtistTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.listArtistTracks("4tZwfgrHOc3mvqYlEYSvVi");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.listArtistTracks("4tZwfgrHOc3mvqYlEYSvVi"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/listArtistTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"4tZwfgrHOc3mvqYlEYSvVi"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.listArtistTracks("4tZwfgrHOc3mvqYlEYSvVi");listNewReleasesGet a page of Spotify's new-release albums for a market.Arguments
Name Type Required limitnumber1-50, default 20.No offsetnumberDefault 0.No countrystringTwo-letter country, e.g. "US".No Returns
SpotifyPagedAlbumsinterface SpotifySimpleAlbum { id: string; name: string; albumType: string; artists: { id: string; name: string }[]; releaseDate: string; totalTracks: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; } interface SpotifyPagedAlbums { albums: SpotifySimpleAlbum[]; total: number; limit: number; offset: number; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/listNewReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.listNewReleases({ limit: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.listNewReleases({"limit": 1}))curl -X POST https://api.bowmark.ai/v1/sites/spotify/listNewReleases \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"opts":{"limit":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.listNewReleases({ limit: 1 });listPlaylistTracksGet a page of a playlist's tracks, with when each was added.Arguments
Name Type Required idstringYes opts.limitnumber1-100, default 50.No opts.offsetnumberDefault 0.No opts.marketstringTwo-letter country, e.g. "US".No Returns
SpotifyPlaylistTracksResultinterface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; } interface SpotifyPlaylistTrackItem { addedAt: string | null; track: SpotifyTrack | null; // null for a local file or a podcast episode } interface SpotifyPlaylistTracksResult { playlistId: string; items: SpotifyPlaylistTrackItem[]; total: number; limit: number; offset: number; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/listPlaylistTracksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.listPlaylistTracks("37i9dQZF1DXaQ34lqGBfrU");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.listPlaylistTracks("37i9dQZF1DXaQ34lqGBfrU"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/listPlaylistTracks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"37i9dQZF1DXaQ34lqGBfrU"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.listPlaylistTracks("37i9dQZF1DXaQ34lqGBfrU");searchSearches Spotify's catalog for tracks, albums, artists, playlists, podcasts or episodes and returns each match's name, artists, album, release date…Arguments
Name Type Required querystringYes opts.typesSpotifySearchType[]Default track, album, artist, playlist.No opts.limitnumberPer type, 1-50, default 10.No opts.marketstringTwo-letter country, e.g. "US".No Returns
SpotifySearchResulttype SpotifySearchType = "track" | "album" | "artist" | "playlist" | "show" | "episode"; interface SpotifySearchItem { type: SpotifySearchType; id: string; name: string; uri: string; // spotify:track:… url: string | null; // open.spotify.com link artists: string[]; album: string | null; owner: string | null; // playlist owner or podcast publisher releaseDate: string | null; durationMs: number | null; explicit: boolean | null; image: string | null; } interface SpotifySearchResult { query: string; results: SpotifySearchItem[]; totals: Partial<Record<SpotifySearchType, number>>; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.search("daft punk", { types: ["artist"], limit: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.search("daft punk", {"types": ["artist"], "limit": 1}))curl -X POST https://api.bowmark.ai/v1/sites/spotify/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"daft punk","opts":{"types":["artist"],"limit":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.search("daft punk", { types: ["artist"], limit: 1 });searchMyLibrarySearch only the signed-in user's own library (Liked Songs, saved albums, followed artists, playlists) by keyword.Arguments
Name Type Required querystringYes opts{ types?: ("track" | "album" | "artist" | "playlist")[]; maxScan?: number }No Returns
SpotifyLibrarySearchResultinterface SpotifyTrack { id: string; name: string; artists: { id: string; name: string }[]; album?: { id: string; name: string }; duration_ms: number; explicit: boolean; popularity: number; external_urls: { spotify: string }; uri: string; } interface SpotifyAlbum { id: string; name: string; artists: { id: string; name: string }[]; release_date: string; total_tracks: number; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; } interface SpotifyArtist { id: string; name: string; genres: string[]; popularity: number; followers: { total: number }; images: { url: string; height?: number; width?: number }[]; external_urls: { spotify: string }; uri: string; } interface SpotifyPlaylist { id: string; name: string; description: string; owner: { id: string; display_name: string }; images: { url: string }[]; tracks: { total: number }; public: boolean; collaborative: boolean; external_urls: { spotify: string }; uri: string; } interface SpotifyLibrarySearchResult { query: string; tracks: SpotifyTrack[]; albums: SpotifyAlbum[]; artists: SpotifyArtist[]; playlists: SpotifyPlaylist[]; /** how many items of each type were read */ scanned: { track?: number; album?: number; artist?: number; playlist?: number }; /** false when the library was larger than maxScan for some type */ complete: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/searchMyLibraryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.searchMyLibrary("daft punk");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.searchMyLibrary("daft punk"))curl -X POST https://api.bowmark.ai/v1/sites/spotify/searchMyLibrary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"daft punk"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.searchMyLibrary("daft punk");searchPlaylistsSearch Spotify for playlists by keyword.Arguments
Name Type Required querystringYes opts{ limit?: number; market?: string }No Returns
SpotifySearchResulttype SpotifySearchType = "track" | "album" | "artist" | "playlist" | "show" | "episode"; interface SpotifySearchItem { type: SpotifySearchType; id: string; name: string; uri: string; // spotify:track:… url: string | null; // open.spotify.com link artists: string[]; album: string | null; owner: string | null; // playlist owner or podcast publisher releaseDate: string | null; durationMs: number | null; explicit: boolean | null; image: string | null; } interface SpotifySearchResult { query: string; results: SpotifySearchItem[]; totals: Partial<Record<SpotifySearchType, number>>; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/spotify/searchPlaylistsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.spotify.searchPlaylists("daft punk", { limit: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.spotify.searchPlaylists("daft punk", {"limit": 1}))curl -X POST https://api.bowmark.ai/v1/sites/spotify/searchPlaylists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"daft punk","opts":{"limit":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.spotify.searchPlaylists("daft punk", { limit: 1 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/spotify/<function> - OpenAPI
/v1/sites/spotify/openapi.json