Send iMessage notifications to iPhone via Mac's Messages app. Supports text, images, videos, audio, files, and URLs. Use when the user wants to send notifications, alerts, or messages to their iPhone from Clawdbot tasks. Triggers on phrases like "send notification to phone", "notify me via iMessage", "message my iPhone", or any request to send iMessage alerts from automated tasks.
iMessage Notification Skill
Send iMessage notifications to your iPhone using Mac's Messages app via AppleScript. Features: Text, Images, Videos, Audio, Files, URLs (with preview)
Prerequisites
- Mac mini (or Mac) with Messages app open and signed in
- iPhone signed into the same Apple ID (iMessage)
- Apple ID: fan.xia@qq.com
Quick Usage
Simple Text Message
./scripts/send-imessage.sh "Your notification message"
# Or shortcut:
~/Document/code/clawd/notify "Hello!"
Multimedia Messages
# Text only
./scripts/send-imessage-media.sh -t "Task completed!"
# Send image
./scripts/send-imessage-media.sh -i ~/Desktop/screenshot.png
# Send video
./scripts/send-imessage-media.sh -v ~/Movies/clip.mp4
# Send audio/voice
./scripts/send-imessage-media.sh -a ~/Desktop/recording.m4a
# Send any file
./scripts/send-imessage-media.sh -f ~/Documents/report.pdf
# Send URL (displays preview)
./scripts/send-imessage-media.sh -u "https://www.apple.com"
# Combined: Text + Image
./scripts/send-imessage-media.sh -t "Check this:" -i ~/Desktop/chart.png
# Combined: Text + Link
./scripts/send-imessage-media.sh -t "Found this:" -u "https://example.com"
Shortcuts
# Quick text
cd ~/Document/code/clawd && ./notify "Hello"
# Quick multimedia
cd ~/Document/code/clawd && ./notify-media -t "Done!" -i result.png
From Clawdbot Tasks
Simple notification
# At the end of a task:
~/Document/code/clawd/notify "🎉 Build finished!"
With screenshot
# Take screenshot and send
screencapture -i ~/Desktop/result.png
~/Document/code/clawd/notify-media -t "Error occurred:" -i ~/Desktop/result.png
Task completion with file
# Generate report and notify
./generate-report.sh
~/Document/code/clawd/notify-media -t "Report ready:" -f ~/output/report.pdf
Options Reference
| Option | Description | Example |
|---|---|---|
-t, --text | Text message | -t "Hello" |
-i, --image | Image file | -i photo.jpg |
-v, --video | Video file | -v clip.mp4 |
-a, --audio | Audio file | -a voice.m4a |
-f, --file | Any file | -f doc.pdf |
-u, --url | URL with preview | -u "https://..." |
-r, --recipient | Override recipient | -r "other@icloud.com" |
-h, --help | Show help | -h |
Script Reference
- scripts/send-imessage.sh - Simple text messages
- scripts/send-imessage-media.sh - Full multimedia support
Related skills
- Downloads
- 1kAll time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
