---
layout: tap
site_name: shortcuts
tap_name: run
description: "Run an Apple Shortcut"
intent: read
columns:
  - output
args:
  - name: name
    type: string
    description: "Shortcut name"
  - name: input
    type: string
    description: "Input text (optional)"
args_json: |
  {"name":{"type":"string","required":true,"description":"Shortcut name"},"input":{"type":"string","default":"","description":"Input text (optional)"}}
health_json: |
  {"min_rows":1,"non_empty":[]}
example_args: ""
source_url: https://github.com/LeonTing1010/tap-skills/blob/main/community/shortcuts/run.plan.json
license: MIT
---

<section>
  <h2>What it does</h2>
  <p>Run an Apple Shortcut</p>
</section>

<section>
  <h2>Install Taprun once</h2>
  <p>Taprun ships as a single MCP server exposing a catalog of compiled taps. One-time setup on macOS / Linux:</p>
  <pre><code>brew install LeonTing1010/tap/taprun
tap mcp connect</code></pre>
  <p>Or drop this into your <code>claude_desktop_config.json</code> (works identically in Claude Code, Cursor, Cline, Windsurf — any MCP host):</p>
  <pre><code>{
  &quot;mcpServers&quot;: {
    &quot;tap&quot;: {
      &quot;command&quot;: &quot;tap&quot;,
      &quot;args&quot;: [&quot;mcp&quot;, &quot;start&quot;]
    }
  }
}</code></pre>
</section>

<section>
  <h2>Call <code>shortcuts/run</code></h2>
  <p>Terminal, once installed:</p>
  <pre><code>tap run shortcuts/run</code></pre>
  <p>From the MCP host — exact same compiled plan, deterministic replay, zero LLM tokens:</p>
  <pre><code>tap.run({ site: &quot;shortcuts&quot;, name: &quot;run&quot; })</code></pre>
</section>

<section>
  <h2>Why compile it once</h2>
  <p>This plan was forged once — the AI read <code>shortcuts</code>, picked stable structural addresses (JSON-LD, ARIA, RSS, or declared API endpoints, in that priority order), and saved them to a <code>.plan.json</code>. Every replay since then has used zero LLM tokens. When <code>shortcuts</code> ships a site change that breaks the extraction, <code>tap verify</code> surfaces it before your data goes stale — not after your pipeline silently writes garbage for a week.</p>
</section>

<section>
  <h2>Related shortcuts taps</h2>
  <table><thead><tr><th>tap</th><th>description</th></tr></thead><tbody>
    <tr><td><a href="/taps/shortcuts/list"><code>shortcuts/list</code></a></td><td>List available Apple Shortcuts</td></tr>
  </tbody></table>
</section>