apple-photos

⚠Review·Scanned 2/18/2026

This skill integrates with Apple Photos.app on macOS to list, search, and export photos via bundled shell scripts and AppleScript. It requests Full Disk Access and instructs running scripts (e.g., scripts/photos-recent.sh, scripts/photos-export.sh) that read ~/Pictures/Photos\ Library.photoslibrary/database/Photos.sqlite and write to /tmp/photo_export.jpg.

from clawhub.ai·ve000189·14.1 KB·0 installs
Scanned from 1.0.0 at e000189 · Transparency log ↗
$ vett add clawhub.ai/tyler6204/apple-photosReview findings below

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

CommandUsage
Library statsscripts/photos-count.sh
List albumsscripts/photos-list-albums.sh
Recent photosscripts/photos-recent.sh [count]
List peoplescripts/photos-list-people.sh
Search by personscripts/photos-search-person.sh <name> [limit]
Search by contentscripts/photos-search-content.sh <query> [limit]
Search by datescripts/photos-search-date.sh <start> [end] [limit]
Photo infoscripts/photos-info.sh <uuid>
Export photoscripts/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

  1. Get UUID: scripts/photos-recent.sh 1
  2. Export: scripts/photos-export.sh "UUID"
  3. View at /tmp/photo_export.jpg

Notes

  • Date format: YYYY-MM-DD or YYYY-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