🎯

spotify-automation

🎯Skill
composiohq/awesome-claude-skills2 Installs66,821Last Updated May 22, 2026

Installation

$npx skills add composiohq/awesome-claude-skills --skill spotify-automation

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/Spotify Automation
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/spotify-automation/
  • All projects ~/.claude/skills/spotify-automation/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

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

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

ParameterTypeRequiredDescription
qstringYesSearch query keywords
typearrayYesItem types: album, artist, playlist, track, show, episode, audiobook
limitintegerNoResults to return (default: 20)
offsetintegerNoOffset for pagination (default: 0)
marketstringNoISO 3166-1 alpha-2 country code
include_externalstringNoSet 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

ParameterTypeRequiredDescription
user_idstringYesSpotify user ID
limitintegerNoMax playlists, 1-50 (default: 20)
offsetintegerNoPagination offset, 0-100000 (default: 0)

Get current user's playlists:

Tool: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS

ParameterTypeRequiredDescription
limitintegerNoMax playlists, 1-50 (default: 20)
offsetintegerNoPagination offset, 0-100000 (default: 0)

Get playlist details:

Tool: SPOTIFY_GET_PLAYLIST

ParameterTypeRequiredDescription
playlist_idstringYesSpotify playlist ID (e.g., 3cEYpjA9oz9GiPac4AsH4n)
fieldsstringNoComma-separated field filter to reduce response size
marketstringNoISO country code for market-specific content
additional_typesstringNotrack,episode to include podcast episodes

Update playlist details:

Tool: SPOTIFY_CHANGE_PLAYLIST_DETAILS

ParameterTypeRequiredDescription
playlist_idstringYesPlaylist ID (must be owned by current user)
namestringNoNew playlist name
descriptionstringNoNew playlist description
publicbooleanNoPublic/private toggle
collaborativebooleanNoCollaborative 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

ParameterTypeRequiredDescription
playlist_idstringYesSpotify playlist ID
limitintegerNoItems per page, 1-50 (default: 20)
offsetintegerNoPagination offset (default: 0)
fieldsstringNoField filter (e.g., items(track(name,id)))
marketstringNoISO country code
additional_typesstringNotrack,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

ParameterTypeRequiredDescription
context_uristringNoSpotify URI of album, artist, or playlist (cannot combine with uris)
urisarrayNoList of track URIs to play (cannot combine with context_uri)
offsetobjectNoStarting position: {position: 5} or {uri: 'spotify:track:...'}
position_msintegerNoStart position in milliseconds
device_idstringNoTarget device ID (defaults to active device)

Requirements: Spotify Premium subscription and at least one active device.


Known Pitfalls

PitfallDetails
Premium required for playbackSPOTIFY_START_RESUME_PLAYBACK returns 403 if the user does not have Spotify Premium
Active device requiredPlayback control returns 404 if no Spotify device (mobile, desktop, web, speaker) is active
context_uri vs uris are exclusiveCannot use both context_uri and uris in the same playback call
Collaborative playlistscollaborative can only be set to true on non-public playlists (public must be false)
Playlist ownershipSPOTIFY_CHANGE_PLAYLIST_DETAILS only works on playlists owned by the authenticated user
Audiobook market restrictionsAudiobooks via search are only available in US, UK, Canada, Ireland, New Zealand, and Australia
Max 11000 playlistsUsers are limited to approximately 11,000 playlists via SPOTIFY_CREATE_PLAYLIST

Quick Reference

Tool SlugPurpose
SPOTIFY_GET_CURRENT_USER_S_PROFILEGet authenticated user's profile
SPOTIFY_SEARCH_FOR_ITEMSearch catalog for tracks, albums, artists, etc.
SPOTIFY_GET_USER_S_PLAYLISTSGet playlists for any user
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTSGet current user's playlists
SPOTIFY_GET_PLAYLISTGet detailed playlist info
SPOTIFY_GET_PLAYLIST_ITEMSList tracks/episodes in a playlist
SPOTIFY_CHANGE_PLAYLIST_DETAILSUpdate playlist name, description, visibility
SPOTIFY_CREATE_PLAYLISTCreate a new playlist
SPOTIFY_ADD_ITEMS_TO_PLAYLISTAdd tracks/episodes to a playlist
SPOTIFY_GET_TRACKGet track details by ID
SPOTIFY_GET_ALBUMGet album details by ID
SPOTIFY_START_RESUME_PLAYBACKStart or resume playback on a device

Powered by Composio

More from this repository10

πŸ”Œ
meeting-insights-analyzerπŸ”ŒPlugin

A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.

πŸ”Œ
video-downloaderπŸ”ŒPlugin

A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.

πŸ”Œ
content-research-writerπŸ”ŒPlugin

A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.

πŸ”Œ
file-organizerπŸ”ŒPlugin

A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.

πŸ”Œ
artifacts-builderπŸ”ŒPlugin

A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.

πŸ”Œ
raffle-winner-pickerπŸ”ŒPlugin

A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.

πŸ”Œ
zoho-crm-automationπŸ”ŒPlugin

A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.

πŸ”Œ
brand-guidelinesπŸ”ŒPlugin

A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.

πŸ”Œ
helpdesk-automationπŸ”ŒPlugin

A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.

πŸ”Œ
changelog-generatorπŸ”ŒPlugin

A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.