shortcuts_list_shortcuts

Retrieve available macOS shortcuts through AppleScript integration, optionally limiting results for focused access.

Instructions

[Shortcuts operations] List all available shortcuts with optional limit

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No	Optional limit on the number of shortcuts to return

Implementation Reference

src/categories/shortcuts.ts:55-87 (handler)

Generates AppleScript to list all shortcuts (with optional limit), formats names as JSON array.

script: (args) => `
  try
    tell application "Shortcuts"
      set shortcutNames to name of every shortcut
      
      ${args.limit ? `
      -- Apply limit if specified
      if (count of shortcutNames) > ${args.limit} then
        set shortcutNames to items 1 through ${args.limit} of shortcutNames
      end if
      ` : ``}
    end tell
    
    -- Convert to JSON string manually
    set jsonOutput to "{"
    set jsonOutput to jsonOutput & "\\"status\\": \\"success\\","
    set jsonOutput to jsonOutput & "\\"shortcuts\\": ["
    
    repeat with i from 1 to count of shortcutNames
      set currentName to item i of shortcutNames
      set jsonOutput to jsonOutput & "{\\"name\\": \\"" & currentName & "\\"}"
      if i < count of shortcutNames then
        set jsonOutput to jsonOutput & ", "
      end if
    end repeat
    
    set jsonOutput to jsonOutput & "]}"
    return jsonOutput
    
  on error errMsg
    return "{\\"status\\": \\"error\\", \\"message\\": \\"" & errMsg & "\\"}"
  end try
`,

src/categories/shortcuts.ts:46-54 (schema)

Defines input schema for the tool, accepting optional 'limit' parameter of type number.

schema: {
  type: "object",
  properties: {
    limit: {
      type: "number",
      description: "Optional limit on the number of shortcuts to return",
    },
  },
},

src/index.ts:33-33 (registration)
Registers the 'shortcuts' category containing the 'list_shortcuts' script, enabling the tool 'shortcuts_list_shortcuts'.
```
server.addCategory(shortcutsCategory);
```

src/framework.ts:223-230 (registration)

Dynamically generates MCP tool list entries, constructing tool name as '{category}_{script}' e.g. 'shortcuts_list_shortcuts'.

category.scripts.map((script) => ({
  name: `${category.name}_${script.name}`, // Changed from dot to underscore
  description: `[${category.description}] ${script.description}`,
  inputSchema: script.schema || {
    type: "object",
    properties: {},
  },
})),

src/framework.ts:275-294 (handler)

Executes the tool by invoking the script generator function with arguments and running the resulting AppleScript via osascript.

const scriptContent =
  typeof script.script === "function"
    ? script.script(request.params.arguments)
    : script.script;

const result = await this.executeScript(scriptContent);

this.log("info", "Tool execution completed successfully", { 
  tool: toolName,
  resultLength: result.length
});

return {
  content: [
    {
      type: "text",
      text: result,
    },
  ],
};

applescript-mcp