apple-photos
Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Apple Photos
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
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-30
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!