mcpField
A
apple-photos

apple-photos

github.com/sundial-orgCreative & media67059 installsUpdated 34w ago
Repository

About apple-photos

apple-photos is a collection of scripts for querying the Apple Photos library through SQLite. It is intended for people who want to inspect albums, people, and photos, search library content, and export images.

Key features

  1. 01View library statistics and albums
  2. 02List recent photos and people
  3. 03Search by person, content, or date
  4. 04Retrieve photo information
  5. 05Export photos with HEIC conversion

Use cases

  1. 01Checking the number of library photos
  2. 02Finding photos by person or date
  3. 03Searching photos by their content
  4. 04Exporting a photo for viewing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill apple-photos

After installing, type/apple-photosin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
photos-count.sh
photos-export.sh
photos-info.sh
photos-list-albums.sh
photos-list-people.sh
photos-recent.sh
photos-search-content.sh
photos-search-date.sh
photos-search-person.sh

Details

From the project README

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

Comments

Markdown supported