Skip to content
All tools

shortcuts_list

Shortcuts · macOS

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Lists the user's macOS Shortcuts (Atajos), each with its stable identifier — the id shortcuts_run and shortcuts_view expect. Pass `folder` to filter to one folder (name or identifier; "none" for shortcuts not in any folder), or `folders: true` to list folder names instead of shortcuts.

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.

Full input schema — macOS
{
  "properties": {
    "folder": {
      "description": "Filter to shortcuts in this folder (name, identifier, or \"none\"). Ignored when folders:true.",
      "type": "string"
    },
    "folders": {
      "description": "List folder names instead of shortcuts. Default false.",
      "type": "boolean"
    }
  },
  "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.

{
  "folder": "Demo shortcuts"
}