spotify_playlists

Retrieve your Spotify playlists to view and manage your music collections. Get a list of your saved playlists with customizable limits for easy organization and access.

Instructions

Lista playlists do usuário

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No	Número máximo de playlists (padrão: 20)

Implementation Reference

src/tools/spotify-tools.ts:412-459 (handler)

The main handler function getPlaylists() that fetches user's playlists from Spotify API, formats them into a text response, and handles errors.

async getPlaylists(limit: number = 20) {
  try {
    await this.spotifyAuth.ensureValidToken();
    const spotifyApi = this.spotifyAuth.getSpotifyApi();

    const response = await spotifyApi.getUserPlaylists({ limit });
    const playlists = response.body.items;

    if (playlists.length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: '❌ Nenhuma playlist encontrada',
          },
        ],
      };
    }

    let content = `📋 **Suas playlists:**\n\n`;
    playlists.forEach((playlist: any, index: number) => {
      content += `${index + 1}. **${playlist.name}**\n`;
      content += `   ID: ${playlist.id}\n`;
      content += `   Descrição: ${playlist.description || 'Sem descrição'}\n`;
      content += `   Total de músicas: ${playlist.tracks.total}\n`;
      content += `   Pública: ${playlist.public ? 'Sim' : 'Não'}\n`;
      content += `   Link: ${playlist.external_urls.spotify}\n\n`;
    });

    return {
      content: [
        {
          type: 'text',
          text: content,
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: 'text',
          text: `❌ Erro ao obter playlists: ${error instanceof Error ? error.message : String(error)}`,
        },
      ],
    };
  }
}

src/index.ts:177-189 (schema)

Input schema for the spotify_playlists tool, specifying an optional 'limit' parameter.

{
  name: 'spotify_playlists',
  description: 'Lista playlists do usuário',
  inputSchema: {
    type: 'object',
    properties: {
      limit: {
        type: 'number',
        description: 'Número máximo de playlists (padrão: 20)',
      },
    },
  },
},

src/index.ts:292-294 (registration)
Registers the tool handler in the CallToolRequestSchema switch statement, delegating to spotifyTools.getPlaylists().
```
case 'spotify_playlists':
  return await spotifyTools.getPlaylists(args.limit);
```
src/index.ts:30-32 (registration)
Instantiates the SpotifyTools class which contains the tool implementations.
```
const spotifyAuth = new SpotifyAuth(config);
const spotifyTools = new SpotifyTools(spotifyAuth);
```

src/types/index.ts:35-50 (schema)

TypeScript interface defining the structure of a Spotify playlist, used in the codebase.

export interface SpotifyPlaylist {
  id: string;
  name: string;
  description: string;
  owner: {
    display_name: string;
  };
  tracks: {
    total: number;
  };
  images: Array<{
    url: string;
    width: number;
    height: number;
  }>;
}

MCP Spotify Server