get_library_playlists
Retrieve all playlists from your Apple Music library. Specify a limit to control the number of playlists returned.
Instructions
List all playlists in your Apple Music library.
Args: limit: Maximum number of playlists to return, 1–100 (default 100).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/mcp_apple_music/server.py:292-312 (handler)The 'get_library_playlists' function is defined as an MCP tool, fetches playlists from the Apple Music API, and formats them for display.
@mcp.tool() async def get_library_playlists(limit: int = 100) -> str: """List all playlists in your Apple Music library. Args: limit: Maximum number of playlists to return, 1–100 (default 100). """ client = _get_client() data = await client.get( "/me/library/playlists", params={"limit": min(max(1, limit), 100)}, ) playlists = data.get("data", []) if not playlists: return "No playlists found in your library." lines = [f"📋 Your Playlists ({len(playlists)} found):\n"] for i, p in enumerate(playlists, 1): lines.append(_fmt_playlist(p, i)) return "\n".join(lines)