Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1500+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Spotify CLI for AI Agents

Use Composio Universal CLI with Spotify. Add these songs to your running playlist, check if i follow taylor swift, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Spotify

Oauth2

Spotify is a streaming service for music and podcasts with millions of tracks from artists worldwide. Enjoy personalized playlists, recommendations, and seamless listening across all your devices.

84 Tools3 Triggers

Managed auth

Connect Spotify without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 1500+ SaaS applications. With Spotify, agents can control playback, create and edit playlists, search music and podcasts, save tracks to your library, and check your top artists, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Spotify automation.

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
Tool discovery: Search, inspect, and execute 20,000+ tools across 1500+ apps from one interface.
Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash

# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Connecting Spotify to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
Prompt it to "Authenticate with Spotify"
Complete the authentication and authorization flow and your Spotify integration is all set.
Start asking anything you want.

Universal CLI Commands for Spotify

You can also manually execute CLI commands to interact with your Spotify.

Connect your Spotify account

Link your Spotify account and verify the connection:

bash

# Connect your Spotify account (opens OAuth flow)
composio connected-accounts link spotify

# Verify the connection
composio connected-accounts list --toolkits spotify

Discover Spotify tools

Search and inspect available Spotify tools:

bash

# List all available Spotify tools
composio tools list --toolkit spotify

# Search for Spotify tools by action
composio tools search "spotify"

# Inspect a tool's input schema
composio tools info SPOTIFY_ADD_ITEMS_TO_PLAYLIST

Common Spotify Actions

Add items to playlist — Add one or more items to a user's playlist

bash

composio tools execute SPOTIFY_ADD_ITEMS_TO_PLAYLIST \
  --playlist_id "<string>"

Add item to playback queue — Add an item to the end of the user's current playback queue

bash

composio tools execute SPOTIFY_ADD_ITEM_TO_PLAYBACK_QUEUE \
  --uri "<string>"

Change playlist details — Change a playlist's name and public/private state

bash

composio tools execute SPOTIFY_CHANGE_PLAYLIST_DETAILS \
  --playlist_id "<string>"

Check if user follows artists or users — Check to see if the current user is following one or more artists or other spotify users

bash

composio tools execute SPOTIFY_CHECK_IF_USER_FOLLOWS_ARTISTS_OR_USERS \
  --ids "<string>" \
  --type "<string>"

Set up Spotify Triggers

Listen for events in real time using triggers:

New Device Added — Triggers when a new device is added

bash

# Find your connected account ID
composio connected-accounts list --toolkits spotify

# Create a trigger
composio triggers create SPOTIFY_NEW_DEVICE_TRIGGER \
  --connected-account-id <your-connected-account-id> \
  --trigger-config '{
  "interval": 2
}'

# Listen for trigger events in real time
composio triggers listen --toolkits spotify --table

Spotify Playlist Item Change — Triggers when songs are added to or removed from a Spotify playlist

bash

# Find your connected account ID
composio connected-accounts list --toolkits spotify

# Create a trigger
composio triggers create SPOTIFY_PLAYLIST_ITEM_TRIGGER \
  --connected-account-id <your-connected-account-id> \
  --trigger-config '{
  "interval": 2,
  "playlist_id": "<string>"
}'

# Listen for trigger events in real time
composio triggers listen --toolkits spotify --table

New Playlist Created or Deleted — Triggers when a new playlist is created or deleted

bash

# Find your connected account ID
composio connected-accounts list --toolkits spotify

# Create a trigger
composio triggers create SPOTIFY_PLAYLIST_TRIGGER \
  --connected-account-id <your-connected-account-id> \
  --trigger-config '{
  "interval": 2
}'

# Listen for trigger events in real time
composio triggers listen --toolkits spotify --table

Generate Type Definitions

Generate typed schemas for Spotify tools to get autocomplete and type safety in your project:

bash

# Auto-detect language
composio generate --toolkits spotify

# TypeScript
composio ts generate --toolkits spotify

# Python
composio py generate --toolkits spotify

Tips & Tricks

Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

Try asking your coding agent to perform various Spotify operations
Explore cross-app workflows by connecting more toolkits
Set up triggers for real-time automation
Use composio generate for typed schemas in your projects

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Spotify action and event your agent gets out of the box.

Add items to playlist

Add one or more items to a user's playlist.

Add item to playback queue

Add an item to the end of the user's current playback queue.

Change playlist details

Change a playlist's name and public/private state.

Check if user follows artists or users

Check whether the current user follows up to 50 specified artists or Spotify users.

Check if users follow playlist

Check whether the authenticated user follows a specified public or owned Spotify playlist.

Check user s saved albums

Check whether up to 20 albums, identified by Spotify ID, are saved in the current user's library.

Check user s saved audiobooks

Check whether up to 50 audiobooks, identified by Spotify ID, are saved in the current user's library.

Check User's Saved Episodes

Check whether up to 50 podcast episodes by ID are saved in the current user's Your Episodes library.

Check user's saved shows

Check whether up to 50 shows, identified by Spotify ID, are saved in the current user's library.

Check User's Saved Tracks

Check whether up to 50 tracks, identified by Spotify track ID, are saved in the current user's library.

Create playlist

Create an empty playlist for a Spotify user, with a name and optional description, visibility, and collaboration settings.

Follow artists or users

Follow one or more artists or Spotify users by ID for the current authenticated user, adding them to the user's following list.

Follow playlist

Follow a playlist for the current Spotify user by playlist ID, publicly or privately.

Get a chapter

Get Spotify catalog information for a single audiobook chapter including name, description, duration, release date, narrators, and playback information.

Get Album Details

Get Spotify catalog information for a single album by ID, including metadata, track listing, artist information and cover artwork.

Get album tracks

Get Spotify catalog information about an album's tracks.

Get an audiobook

Get Spotify catalog information for a single audiobook.

Get artist

Get detailed Spotify catalog information for a single artist, including name, genres, profile images and Spotify links.

Get artist s albums

Get Spotify catalog information about an artist's albums.

Get artist s related artists

Get Spotify catalog information about artists similar to a given artist.

Get Artist's Top Tracks

Get Spotify catalog information about an artist's top tracks in a specified market, defaulting to the US.

Get audiobook chapters

Get Spotify catalog information about an audiobook's chapters.

Get Available Devices

Get information about the user's available Spotify Connect devices.

Get available markets

Get the list of markets where Spotify is available, as ISO 3166-1 alpha-2 country codes.

Get currently playing track

Get the object currently being played on the user's Spotify account.

Get current user s playlists

Get a paginated list of playlists owned or followed by the current Spotify user, with playlist metadata and pagination links.

Get current user s profile

Get profile information for the current authenticated Spotify user, including available display name, images and Spotify URIs.

Get episode

Get Spotify catalog information for a single podcast episode identified by its unique Spotify ID.

Get featured playlists

Get a list of Spotify's editorially curated featured playlists.

Get followed artists

Get a cursor-paginated list of artists followed by the current Spotify user using the after parameter; requires user-follow-read.

Get new releases

Get a page of new album releases featured by Spotify, such as those shown in Browse.

Get playback state

Get the current user's Spotify playback state, including the active device, current track or episode, progress, playback context, and repeat and shuffle settings.

Get playlist

Get metadata and available contents of a Spotify playlist, with optional field filtering.

Get playlist cover image

Get the current cover images associated with a playlist.

Get playlist items

Get a paginated list of tracks or episodes in a playlist, with optional response field filtering.

Get recently played tracks

Get tracks from the current user's recently played tracks.

Get recommendations

Get track recommendations based on seed artists, genres, and/or tracks.

Get several albums

Get Spotify catalog information for up to 20 albums by Spotify ID, optionally specifying a market.

Get several artists

Get Spotify catalog information for up to 50 artists in one request using their Spotify IDs.

Get several audiobooks

Get Spotify catalog information for up to 50 audiobooks by ID in a single request, optionally specifying a market.

Get several browse categories

List Spotify browse categories used to tag items, with locale and limit/offset pagination.

Get several chapters

Get Spotify catalog details for up to 50 audiobook chapters by ID, including chapter metadata and parent audiobook information.

Get several episodes

Get Spotify catalog information for up to 50 episodes by their IDs in a single request, with an optional market.

Get several shows

Get Spotify catalog information for up to 50 shows by ID in a single request, optionally specifying a market.

Get several tracks

Get Spotify catalog information for multiple tracks by Spotify ID, with an optional market.

Get show

Get Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.

Get show episodes

Get Spotify catalog information about a show's episodes.

Get single browse category

Get information about a Spotify browse category by ID, including its name and icons, with an optional locale.

Get the user's queue

Get the list of tracks and episodes in the user's playback queue.

Get track

Get Spotify catalog information for a single track identified by its unique Spotify ID.

Get Track's Audio Analysis

Get a comprehensive audio analysis for a Spotify track.

Get user's playlists

Get a paginated list of playlists owned or followed by a specified Spotify user, using limit and offset.

Get user's profile

Retrieve public profile information for a Spotify user by user ID, such as their display name and profile images.

Get user s saved albums

Get a list of albums saved in the current Spotify user's library ('Your Music').

Get user s saved audiobooks

Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.

Get user's saved episodes

Get a list of episodes saved in the current Spotify user's library.

Get User's Saved Shows

Get a list of shows saved in the current Spotify user's library.

Get User's Saved Tracks

Get a list of the songs saved in the current Spotify user's 'Your Music' library.

Get User's Top Artists

Get a paginated list of the current user's top artists based on listening affinity over a selected time range; requires user-top-read.

Get User's Top Tracks

Get the current user's top tracks based on listening affinity over a selected time range.

Pause playback

Pause playback on the user's account.

Remove playlist items

Remove one or more items from a user's playlist.

Remove users saved albums

Remove one or more albums from the current user's saved library.

Remove User's Saved Audiobooks

Remove one or more saved audiobooks from the current user's Spotify library by ID.

Remove user's saved episodes

Remove up to 50 episodes by ID from the current user's Your Episodes library; removing an unsaved episode succeeds.

Remove user s saved shows

Remove one or more shows by Spotify ID from the current user's library.

Remove user s saved tracks

Remove one or more tracks by Spotify ID from the current user's library.

Save albums for current user

Save one or more albums by Spotify ID to the current user's library.

Save audiobooks for current user

Save up to 50 audiobooks by Spotify ID to the current user's library for later access.

Save episodes for current user

Save up to 50 podcast episodes by Spotify ID to the current user's Your Episodes library for later playback.

Save shows for current user

Save up to 50 shows by Spotify ID to the current user's library.

Save tracks for current user

Save tracks to the current user's Spotify library using up to 50 track IDs or timestamped IDs.

Search for item

Search Spotify's catalog for albums, artists, playlists, tracks, shows, episodes or audiobooks matching a keyword.

Seek to position

Seek to a position in milliseconds in the user's currently playing track, targeting a specified device or the active device by default.

Set playback volume

Set the volume for the user's current playback device.

Set repeat mode

Set the repeat mode for the user's playback.

Skip to next

Skips to next track in the user's queue.

Skip to previous

Skips to the previous track in the user's queue.

Start resume playback

Start playback of a context or list of tracks, or resume playback on a Spotify device.

Toggle playback shuffle

Toggle shuffle on or off for user's playback.

Transfer playback

Transfer playback to a new device and optionally begin playback.

Unfollow artists or users

Unfollow up to 50 artists or Spotify users by ID for the current user, removing them from the following list.

Unfollow playlist

Unfollow a playlist by ID for the current user, removing it from their followed playlists.

Update playlist items

Either replace all tracks in a playlist OR reorder existing tracks within it.

FRAMEWORKS

How to build Spotify MCP Agent with another framework

Claude Code

Use Spotify MCP with Claude Code

Cursor

Use Spotify MCP with Cursor

ChatGPT

Use Spotify MCP with ChatGPT

Claude Cowork

Use Spotify MCP with Claude Cowork

Antigravity

Use Spotify MCP with Antigravity

OpenAI Agents SDK

Use Spotify MCP with OpenAI Agents SDK

Claude Agent SDK

Use Spotify MCP with Claude Agent SDK

Grok Bot

Use Spotify MCP with Grok Bot

Codex

Use Spotify MCP with Codex

Kimi Code

Use Spotify MCP with Kimi Code

Grok Build

Use Spotify MCP with Grok Build

VS Code

Use Spotify MCP with VS Code

OpenCode

Use Spotify MCP with OpenCode

OpenClaw

Use Spotify MCP with OpenClaw

Hermes

Use Spotify MCP with Hermes

Atomic Agent

Use Spotify MCP with Atomic Agent

Google ADK

Use Spotify MCP with Google ADK

LangChain

Use Spotify MCP with LangChain

Vercel AI SDK

Use Spotify MCP with Vercel AI SDK

Mastra AI

Use Spotify MCP with Mastra AI

LlamaIndex

Use Spotify MCP with LlamaIndex

CrewAI

Use Spotify MCP with CrewAI

Pydantic AI

Use Spotify MCP with Pydantic AI

AutoGen

Use Spotify MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Youtube

Oauth2

YouTube is a leading video-sharing platform for uploading, streaming, and discovering content. It empowers creators and businesses to reach global audiences and monetize their work.

AllTrails MCP

No Auth

AllTrails MCP is a trail discovery service for hiking, biking, and running routes. Use it to find reviewed trails, photos, maps, difficulty info, and route details fast.

Amara

Api Key

Amara is a collaborative platform for creating and managing subtitles and captions for videos. It helps make content accessible and multilingual for global audiences.

Captions

Api Key

Captions provides the Mirage API for generating videos, speech, and styled captions. Use it to automate polished video creation, voiceovers, and captioning from one API.

FAQ

Frequently asked questions

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 1500+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Spotify and other connected apps.

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Spotify data and credentials are handled as safely as possible. You can also bring your own OAuth credentials for full control.

Start with Spotify.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Spotify tool your agent needs.Free to start.

Start building

Spotify CLI for AI Agents

Connect Spotify without auth hassles

Introduction

Also integrate Spotify with

What is Universal CLI and why use it?

Prerequisites

Connecting Spotify to Coding Agents via Universal CLI

Universal CLI Commands for Spotify

Connect your Spotify account

Discover Spotify tools

Common Spotify Actions

Add items to playlist — Add one or more items to a user's playlist

Add item to playback queue — Add an item to the end of the user's current playback queue

Change playlist details — Change a playlist's name and public/private state

Check if user follows artists or users — Check to see if the current user is following one or more artists or other spotify users

Set up Spotify Triggers

New Device Added — Triggers when a new device is added

Spotify Playlist Item Change — Triggers when songs are added to or removed from a Spotify playlist

New Playlist Created or Deleted — Triggers when a new playlist is created or deleted

Generate Type Definitions

Tips & Tricks

Next Steps

Supported Tools and Triggers

How to build Spotify MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Grok Bot

Codex

Kimi Code

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Youtube

AllTrails MCP

Amara

Captions

Frequently asked questions

What is the Composio Universal CLI?+

Which coding agents work with the Composio CLI?+

How is the CLI different from using an MCP server for Spotify?+

How safe is my Spotify data when using the Composio CLI?+

Start with Spotify.It takes 30 seconds.