Apple Photos
SkillSearchApple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Apple Photos skill
What this skill tells your AI
The instructions your AI receives, as published by sundial-org/awesome-openclaw-skills in skills/apple-photos/SKILL.md and read by ahel’s review.
Access Photos.app via SQLite queries. Run scripts from: cd {baseDir}
Requirements
- Full Disk Access for terminal (System Settings → Privacy → Full Disk Access)
Commands
| Command | Usage |
|---|---|
| Library stats | scripts/photos-count.sh |
| List albums | scripts/photos-list-albums.sh |
| Recent photos | scripts/photos-recent.sh [count] |
| List people | scripts/photos-list-people.sh |
| Search by person | scripts/photos-search-person.sh <name> [limit] |
| Search by content | scripts/photos-search-content.sh <query> [limit] |
| Search by date | scripts/photos-search-date.sh <start> [end] [limit] |
| Photo info | scripts/photos-info.sh <uuid> |
| Export photo | scripts/photos-export.sh <uuid> [output_path] |
Output
- Recent/search:
Filename | Date | Type | UUID - People:
ID | Name | Photo Count - Default export:
/tmp/photo_export.jpg
Workflow: View a Photo
- Get UUID:
scripts/photos-recent.sh 1 - Export:
scripts/photos-export.sh "UUID" - View at
/tmp/photo_export.jpg
Notes
- Date format:
YYYY-MM-DDorYYYY-MM-DD HH:MM - Content search uses ML, slower (~5-10s) than date/person (~100ms)
- HEIC auto-converts to JPEG on export
- Name search is case-insensitive, partial match
Signals
- GitHub stars
- 661
- Forks
- 97
- Last commit
- Mar 2026
Advanced
- Catalog kind
- skill
- Gateway key
apple-photos- Source
- github.com/sundial-org/awesome-openclaw-skills