Shortcuts Bridge

Trigger macOS Shortcuts from Claude via a local HTTP bridge server running on the user's Mac.

Prerequisites

The user must have shortcuts_bridge.py running:

python3 shortcuts_bridge.py

Bridge URL: http://127.0.0.1:9876

Security defaults:

• •allow_remote_clients should stay false
• •auth_token should be set for POST endpoints
• •enable_savefile should stay false unless needed
• •Browser calls require cors_allowed_origins to include the page origin

Step 1: Check Available Shortcuts

Read the bridge health endpoint and only use shortcuts in allowed_shortcuts:

fetch('http://127.0.0.1:9876/health').then(r => r.json()).then(console.log)

If token auth is enabled, include header X-Bridge-Token.

Step 2: Trigger via Browser JavaScript

If direct shell HTTP calls are unavailable, use browser JavaScript:

(async () => {
  const r = await fetch('http://127.0.0.1:9876/run', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Bridge-Token': 'YOUR_TOKEN_IF_REQUIRED'
    },
    body: JSON.stringify({
      shortcut: 'SHORTCUT_NAME',
      input: 'Your message or input here'
    })
  });
  return await r.text();
})()

Response Format

Success: {"success": true, "shortcut": "SendText"} Error: {"error": "...", "allowed": ["SendText", ...]}

Adding New Shortcuts

User must:

1. •Create a Shortcut in Shortcuts.app (accepts text input if needed)
2. •Add shortcut name to allowed_shortcuts in shortcuts_bridge.local.json
3. •Restart the server

Common Shortcut Pattern

Troubleshooting

• •Timeout/no response: server not running or crashed. Restart shortcuts_bridge.py.
• •Connection refused: bridge not started.
• •Shortcut not in allowlist: add it to allowed_shortcuts and restart.