music_list_playlists

macOS

Purpose

Lists the playlists of the Music app: id, name, kind (playlist or folder) and total length. With `playlist` (a name or an id) it lists that playlist's tracks instead, in playlist order. Both lists are paged with limit and offset. Opens the Music app when it is closed.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

• Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

{
  "properties": {
    "limit": {
      "description": "Rows per page (default 100, max 500).",
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Rows to skip (default 0).",
      "type": "integer"
    },
    "playlist": {
      "description": "Playlist name or id. When given, its tracks are returned.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 50
}