Spotify Automation

composio-community/awesome-codex-skillsOther Tools and IntegrationsAudit passedSnapshot 0adfa868023c

Installs: 0

Summary

Automate Spotify workflows including playlist management, music search, playback control, and user profile access via Composio

SKILL.md

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 https://rube.app/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

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)

Parameter	Type	Required	Description
`limit`	integer	No	Max playlists, 1-50 (default: 20)
`offset`	integer	No	Pagination offset, 0-100000 (default: 0)

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

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)

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

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)

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`

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

Spotify Automation

Summary

SKILL.md

Spotify Automation

Setup

Core Workflows

1. Get Current User Profile

2. Search the Spotify Catalog

3. Manage Playlists

4. Browse Playlist Items & Add Tracks

5. Get Track & Album Details

6. Control Playback

Known Pitfalls

Quick Reference

Related skills