data
Spotify MCP, CLI, and Lua Integration for AI Agents
Spotify integration docs for AI agents: MCP gateway setup, Spotify CLI commands, Lua API reference, credentials, and function schemas.Spotify for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
spotify.spotify_search | Read read | 4 | Search for tracks, artists, albums, or playlists on Spotify. Returns matching items with basic metadata. Use specific get tools for detailed information about a single item. |
spotify.spotify_get_track | Read read | 1 | Get detailed information about a specific Spotify track, including artists, album, duration, and popularity. |
spotify.spotify_get_artist | Read read | 1 | Get detailed information about a specific Spotify artist, including followers, genres, and popularity. |
spotify.spotify_list_playlists | Read read | 2 | List the current user's Spotify playlists. Returns playlist names, IDs, and track counts. |
spotify.spotify_get_playlist | Read read | 3 | Get detailed information about a Spotify playlist, including its tracks with artist and album details. |
spotify.spotify_create_playlist | Write write | 4 | Create a new Spotify playlist for the current user. Use the "Get Current User" tool first if you need the user ID. |
spotify.spotify_list_albums | Read read | 4 | List albums by a specific Spotify artist. Includes singles and compilations by default. |
spotify.spotify_get_current_user | Read read | 0 | Get the authenticated user's Spotify profile, including their user ID (needed for creating playlists), display name, and follower count. |