Spotify automation

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

1. Connect your Spotify account through the Composio MCP server at https://rube.app/mcp
2. The agent will prompt you with an authentication link if no active connection exists
3. Once connected, all SPOTIFY_* tools become available for execution
4. 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_ur