music_search_library

macOS

Purpose

Searches the tracks of the user's Music library. `field` narrows the search to title, artist or album; the default, any, searches every text field the Music app's own search does. Returns each track's id, title, artist, album and length; the id is what music_playback and music_add_to_playlist take. Only the library is searched, not the Apple Music catalog. Opens the Music app when it is closed.

Required inputs

• query — Text to look for.

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": {
    "field": {
      "description": "Where to look (default any).",
      "enum": [
        "any",
        "title",
        "artist",
        "album"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Tracks to return (default 25, max 100).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "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.

{
  "field": "title",
  "limit": 10,
  "query": "Moonlight Sonata"
}