---
name: apple-shortcuts
description: Generate Apple Shortcuts (.shortcut files) and create URL scheme integrations for iOS/macOS automation. Bridge Apple Shortcuts with OpenClaw, Home Assistant, Notion, n8n, and more.
metadata: {"version": "1.0.0", "author": "OpenClaw Community", "requires": ["python3"]}
---

# Apple Shortcuts Generator

Generate custom Apple Shortcuts (.shortcut files) and create URL scheme integrations for seamless iOS/macOS automation.

## Features

1. **Generate .shortcut files** - Download and install directly on iPhone/Mac
2. **URL Scheme integrations** - Shortcuts that communicate back to OpenClaw
3. **Pre-built templates** - Common automations ready to use
4. **Custom shortcut builder** - Describe what you want, get a working shortcut

## Quick Start

### Generate a Shortcut

```bash
python3 skills/apple-shortcuts/scripts/generate.py \
  --name "Quick Notion Note" \
  --type voice-to-notion \
  --output ~/Downloads/
```

### Create URL Scheme Integration

```bash
python3 skills/apple-shortcuts/scripts/url-scheme.py \
  --action send-telegram \
  --message "Hello from Shortcuts!"
```

## Pre-built Templates

### 1. Voice to Notion
Records audio → Transcribes → Adds to Notion inbox

```bash
python3 skills/apple-shortcuts/scripts/generate.py --template voice-to-notion
```

### 2. Quick Expense Logger
Amount + Category → Logs to Notion database

```bash
python3 skills/apple-shortcuts/scripts/generate.py --template expense-logger
```

### 3. Home Assistant Scene Trigger
One-tap scene activation

```bash
python3 skills/apple-shortcuts/scripts/generate.py --template ha-scene \
  --scene "Movie Night"
```

### 4. Morning Briefing Trigger
Manually trigger your Morning Intelligence Briefing

```bash
python3 skills/apple-shortcuts/scripts/generate.py --template morning-briefing
```

### 5. Send to OpenClaw
Send any text/data to OpenClaw via Telegram

```bash
python3 skills/apple-shortcuts/scripts/generate.py --template send-to-openclaw
```

## URL Scheme Reference

### Open Telegram
```
shortcuts://run-shortcut?name=Send%20to%20OpenClaw&input=text&text=Hello
```

### Trigger n8n Webhook
```
https://n8n.kangaroo-eel.ts.net/webhook/trigger-morning-briefing
```

### Call OpenClaw Directly
```
https://t.me/clawdbot?start=shortcut_<encoded_message>
```

## Custom Shortcuts

Describe what you want, and I'll generate it:

**Example:**
> "I want a shortcut that takes a photo of a receipt, extracts the total, and logs it to my Notion expenses database with today's date"

**Result:** Generated .shortcut file ready to install!

## Installation

1. Generate the shortcut file
2. AirDrop or save to Files app
3. Tap the file → "Add Shortcut"
4. Done!

## Advanced: Two-Way Communication

Shortcuts can send data TO OpenClaw and receive responses:

### From Shortcut → OpenClaw
1. Shortcut collects data (text, photo, location, etc.)
2. Sends via Telegram bot API or webhook
3. OpenClaw processes and responds

### From OpenClaw → Shortcut
1. OpenClaw generates a shortcut file
2. Sends download link via Telegram
3. User installs on device

## Security Notes

- API keys are embedded in shortcuts (keep them private!)
- Use webhook endpoints that don't expose sensitive data
- Shortcuts run locally on your device

## Troubleshooting

**Shortcut won't install:** Check iOS version (requires iOS 14+)
**Webhook fails:** Verify URL is accessible from your network
**Notion auth fails:** Check API key has correct permissions
