EosBot Spotify Automation
Automate Spotify operations -- manage playlists, search the music catalog, control playback, browse albums and tracks, and access user profiles -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/spotify
Setup
- Connect your Spotify account through the Composio MCP server at
http://localhost:8787/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
SPOTIFY_*tools become available for execution - Note: Some features (playback control) require a Spotify Premium subscription
Core Workflows
1. Get Current User Profile
Retrieve comprehensive profile information for the authenticated Spotify user.
Tool: SPOTIFY_GET_CURRENT_USER_S_PROFILE
No parameters required.
Returns: display name, email, country, subscription level (premium/free),
explicit content settings, profile images, follower count, and Spotify URIs.
Required scopes: user-read-private, user-read-email.
2. Search the Spotify Catalog
Find albums, artists, playlists, tracks, shows, episodes, or audiobooks by keyword.
Tool: SPOTIFY_SEARCH_FOR_ITEM
| Parameter | Type | Required | Description |
|---|---|---|---|
q |
string | Yes | Search query keywords |
type |
array | Yes | Item types: album, artist, playlist, track, show, episode, audiobook |
limit |
integer | No | Results to return (default: 20) |
offset |
integer | No | Offset for pagination (default: 0) |
market |
string | No | ISO 3166-1 alpha-2 country code |
include_external |
string | No | Set to audio to include external content |
Note: Audiobooks are only available in US, UK, Canada, Ireland, New Zealand, and Australia.
3. Manage Playlists
Browse, create, modify, and populate playlists.
Get a user's playlists:
Tool: SPOTIFY_GET_USER_S_PLAYLISTS
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id |
string | Yes | Spotify user ID |
limit |
integer | No | Max playlists, 1-50 (default: 20) |
offset |
integer | No | Pagination offset, 0-100000 (default: 0) |
Get current user's playlists:
Tool: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS
| Parameter | Type | Required | Description |
|---|---|---|---|
limit |
integer | No | Max playlists, 1-50 (default: 20) |
offset |
integer | No | Pagination offset, 0-100000 (default: 0) |
Get playlist details:
Tool: SPOTIFY_GET_PLAYLIST
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id |
string | Yes | Spotify playlist ID (e.g., 3cEYpjA9oz9GiPac4AsH4n) |
fields |
string | No | Comma-separated field filter to reduce response size |
market |
string | No | ISO country code for market-specific content |
additional_types |
string | No | track,episode to include podcast episodes |
Update playlist details:
Tool: SPOTIFY_CHANGE_PLAYLIST_DETAILS
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id |
string | Yes | Playlist ID (must be owned by current user) |
name |
string | No | New playlist name |
description |
string | No | New playlist description |
public |
boolean | No | Public/private toggle |
collaborative |
boolean | No | Collaborative mode (only on non-public playlists) |
4. Browse Playlist Items & Add Tracks
View tracks in a playlist and add new items.
Tool: SPOTIFY_GET_PLAYLIST_ITEMS
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id |
string | Yes | Spotify playlist ID |
limit |
integer | No | Items per page, 1-50 (default: 20) |
offset |
integer | No | Pagination offset (default: 0) |
fields |
string | No | Field filter (e.g., items(track(name,id))) |
market |
string | No | ISO country code |
additional_types |
string | No | track,episode for podcast episodes |
Tool: SPOTIFY_ADD_ITEMS_TO_PLAYLIST
Add tracks or episodes to a playlist using Spotify URIs.
5. Get Track & Album Details
Retrieve catalog information for individual tracks and albums.
Tool: SPOTIFY_GET_TRACK -- Get details for a single track by Spotify ID.
Tool: SPOTIFY_GET_ALBUM -- Get comprehensive album data including track listing, artist info, cover art, and popularity.
6. Control Playback
Start, resume, or change playback on the user's active device.
Tool: SPOTIFY_START_RESUME_PLAYBACK
| Parameter | Type | Required | Description |
|---|---|---|---|
context_uri |
string | No | Spotify URI of album, artist, or playlist (cannot combine with uris) |
uris |
array | No | List of track URIs to play (cannot combine with context_uri) |
offset |
object | No | Starting position: {position: 5} or {uri: 'spotify:track:...'} |
position_ms |
integer | No | Start position in milliseconds |
device_id |
string | No | Target device ID (defaults to active device) |
Requirements: Spotify Premium subscription and at least one active device.
Known Pitfalls
| Pitfall | Details |
|---|---|
| Premium required for playback | SPOTIFY_START_RESUME_PLAYBACK returns 403 if the user does not have Spotify Premium |
| Active device required | Playback control returns 404 if no Spotify device (mobile, desktop, web, speaker) is active |
| context_uri vs uris are exclusive | Cannot use both context_uri and uris in the same playback call |
| Collaborative playlists | collaborative can only be set to true on non-public playlists (public must be false) |
| Playlist ownership | SPOTIFY_CHANGE_PLAYLIST_DETAILS only works on playlists owned by the authenticated user |
| Audiobook market restrictions | Audiobooks via search are only available in US, UK, Canada, Ireland, New Zealand, and Australia |
| Max 11000 playlists | Users are limited to approximately 11,000 playlists via SPOTIFY_CREATE_PLAYLIST |
Quick Reference
| Tool Slug | Purpose |
|---|---|
SPOTIFY_GET_CURRENT_USER_S_PROFILE |
Get authenticated user's profile |
SPOTIFY_SEARCH_FOR_ITEM |
Search catalog for tracks, albums, artists, etc. |
SPOTIFY_GET_USER_S_PLAYLISTS |
Get playlists for any user |
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS |
Get current user's playlists |
SPOTIFY_GET_PLAYLIST |
Get detailed playlist info |
SPOTIFY_GET_PLAYLIST_ITEMS |
List tracks/episodes in a playlist |
SPOTIFY_CHANGE_PLAYLIST_DETAILS |
Update playlist name, description, visibility |
SPOTIFY_CREATE_PLAYLIST |
Create a new playlist |
SPOTIFY_ADD_ITEMS_TO_PLAYLIST |
Add tracks/episodes to a playlist |
SPOTIFY_GET_TRACK |
Get track details by ID |
SPOTIFY_GET_ALBUM |
Get album details by ID |
SPOTIFY_START_RESUME_PLAYBACK |
Start or resume playback on a device |
Powered by Composio