apple-photos

Query Apple Photos library for recent photos and OCR text searches.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/g-shudy/claude-plugins --skill apple-photos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-photos
Source: https://github.com/g-shudy/claude-plugins/tree/main/plugins/macos-apple-apps/skills/apple-photos
Command: npx skills add https://github.com/g-shudy/claude-plugins --skill apple-photos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables direct read-only access to Apple Photos data, allowing you to locate recent images, search by visible text using OCR, and retrieve file paths and metadata without opening the Photos app.

Core Features & Use Cases

  • Recent photo retrieval: Return the most recent photo(s) with their file paths.
  • OCR/Text search: Find photos by text present in images using OCR data.
  • Metadata access: Retrieve photo metadata and original storage locations for downstream processing.

Quick Start

Use the apple-photos skill to locate the most recent photo or search for text like "invoice" across your library to obtain file paths and metadata.

Frequently Asked Questions about apple-photos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Apple Photos by text in images?

Search Apple Photos by OCR to find images containing specific visible text. This Skill queries the OCR index in your Photos.sqlite database, returning file paths and metadata for matching images without opening the Photos app.

Can I retrieve file paths from Apple Photos for processing?

Yes. This Skill accesses your Photos.sqlite database with read-only permissions to retrieve exact file paths and metadata for recent photos or search results, enabling downstream processing, sharing, or content review.

How do I find the most recent photos in my Apple Photos library?

Query your Apple Photos library to return the most recent photo or photos with their file paths and metadata. This Skill reads both modern and legacy file locations from Photos.sqlite.

What metadata can I extract from Apple Photos?

Retrieve structured metadata including file paths, OCR text data, and photo properties from your Photos.sqlite database. The Skill operates with read-only access to support metadata review and downstream processing workflows.

Does this work with both current and older Apple Photos storage formats?

Yes. This Skill reads both modern and legacy file locations within Apple Photos, ensuring compatibility across different Photos.sqlite database versions and storage configurations.

Do I need to open the Photos app to search my library?

No. This Skill provides direct read-only access to your Photos.sqlite database, allowing OCR and metadata searches without launching the Photos app.