mcp-apple-music

Instructions

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)