Tools
| Name | Description |
|---|---|
searchSearches for tracks, artists, albums, etc. | Searches for tracks, artists, albums, etc. |
get_playback_stateRetrieves the current playback state of the player | Retrieves the current playback state of the player |
playResumes or starts playback | Resumes or starts playback |
pausePauses the playback | Pauses the playback |
set_volumeSets the volume of the player | Sets the volume of the player |
get_playlistsRetrieves the list of playlists that you created or followed | Retrieves the list of playlists that you created or followed |
get_playlist_infoRetrieves details of a playlist | Retrieves details of a playlist |
get_playlist_itemsRetrieves the list of items in the playlist | Retrieves the list of items in the playlist |
get_saved_tracksRetrieves the list of saved tracks for the current user | Retrieves the list of saved tracks for the current user |
create_playlistCreates a new playlist for the current user | Creates a new playlist for the current user |
update_playlistUpdates details of the playlist | Updates details of the playlist |
add_playlist_itemsAdds tracks or episodes to the playlist | Adds tracks or episodes to the playlist |
remove_playlist_itemsRemoves tracks or episodes from the playlist | Removes tracks or episodes from the playlist |
reorder_playlistReorders items in the playlist | Reorders items in the playlist |
custom_api_callMake a custom API call to a specific endpoint | Make a custom API call to a specific endpoint |
Triggers
| Name | Description |
|---|---|
playlist_items_changedTriggers when the items of a playlist change | Triggers when the items of a playlist change |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('spotify', 'search', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'spotify',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Spotify to my app?
Use Weavz Hosted Connect for OAuth2 authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Spotify support?
Spotify supports 15 tools including Search, Get Playback State, Play / Resume, Pause, Set Volume, and more.
Can I use Spotify with AI agents?
Yes. Add Spotify to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Spotify to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Spotify as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Spotify tools exposed by that workspace.
Does Spotify work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Spotify work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Spotify?
Spotify exposes 15 tools, including Search, Get Playback State, Play / Resume, Pause, Set Volume, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Spotify be used in stateful agent workflows?
Yes. Agents can combine Spotify tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Spotify use?
Spotify uses OAuth2. Weavz stores OAuth credentials securely and refreshes tokens when supported by the provider.
How much does the Spotify integration cost?
The Spotify integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Spotify support?
Spotify supports 1 triggers including Playlist Items Changed.
Connect Spotify in minutes
Get 20,000 free action executions every month. No credit card required.