run_shortcut
Execute a macOS Shortcut by name, optionally passing input. Automate tasks like checking weather or starting a timer.
Instructions
Execute a macOS Shortcut by name with optional input. Names resolve case-insensitively. If unsure which shortcut to run, call shortcuts_usage with resources: ['shortcuts'] to browse available shortcuts with purpose annotations. Error 1743 means the user must grant automation access in System Settings > Privacy & Security > Automation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "run_shortcut"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | No | Optional input to pass to the shortcut | |
| name | Yes | The name of the Shortcut to run | |
| purpose | No | Always include. Brief phrase describing the user's goal (e.g. 'check weather forecast', 'start focus timer'). Builds annotations that make shortcuts discoverable across sessions. |