query

MCP tool from Apple Photos MCP by sweetrb

Search the library with combinable filters. Returns photo summaries with UUIDs — use get-photo for full details on a specific match.

How to use it

query is exposed by the Apple Photos MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the query tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Apple Photos MCP

$claude mcp add apple-photos -s user -- npx -y apple-photos-mcp

FULL APPLE PHOTOS MCP LISTING

Other tools in Apple Photos MCP (39)

string

string

string

string[]

boolean

boolean

string

string

Run a full setup diagnostic — six checks: the resolved Python interpreter (path + version — warns when it's older than the required 3.11, with brew install python@3.12 advice), osxphotos installation, sidecar mode (persistent vs one-shot fallback, plus the last respawn), the write-tools gate (enable

boolean

string[]

string

Get full metadata for a single photo by UUID.

get-photos

Get full metadata for a batch of photos (up to 50) in one call — the batch equivalent of get-photo, for dedupe reviews, EXIF audits, and captioning passes.

hasLocation

boolean

health-check

Verify osxphotos is installed and the Photos library can be opened.

boolean

string[]

string[]

string