Setup & Installation
openclaw skills install @tyler6204/apple-photos
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install apple-photos
What This Skill Does
Provides terminal access to macOS Photos.app by querying the Photos SQLite database directly. Supports listing albums and people, searching photos by date range, person name, or visual content, and exporting photos to JPEG.
Direct SQLite queries return date and person search results in under 100ms without opening the Photos GUI.
When to use it
- Finding all photos of a specific person in your library
- Exporting a photo by UUID for use in another script
- Searching for photos taken during a specific date range
- Listing all albums to audit library organization
- Checking library stats to see total photo count
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: show me the most recent photo and export it
AGENT
- 1Run scripts/photos-recent.sh 1 to retrieve the most recent photo with its UUID
- 2Parse the UUID from the output
- 3Run scripts/photos-export.sh <UUID> to export the photo to /tmp/photo_export.jpg
- 4Report the filename, date, and export path to the user
OUTPUT
Photo exported to /tmp/photo_export.jpg with filename and capture date confirmed
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
Full Disk Access granted to Terminal in System Settings → Privacy & Security → Full Disk Access