ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

apple-photos

Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/tyler6204/apple-photos
Or

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
Read Full Documentation on GitHub

Metadata

Author@tyler6204
Stars946
Views1
Updated2026-02-13
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-tyler6204-apple-photos": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

apple-mail

Apple Mail.app integration for macOS. Read inbox, search emails, send emails, reply, and manage messages with fast direct access (no enumeration).

tyler6204 946

apple-contacts

Look up contacts from macOS Contacts.app. Use when resolving phone numbers to names, finding contact info, or searching the address book.

tyler6204 946

better-notion

Full CRUD for Notion pages, databases, and blocks. Create, read, update, delete, search, and query.

tyler6204 946

apple-calendar

Apple Calendar.app integration for macOS. CRUD operations for events, search, and multi-calendar support.

tyler6204 946

apple-music

Search Apple Music, add songs to library, manage playlists, control playback and AirPlay.

tyler6204 946