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.
How to use it
get-photos is exposed by the Apple Photos MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get-photos 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-mcpOther 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.
boolean
Verify osxphotos is installed and the Photos library can be opened.
boolean
string[]
string[]
string
High-level stats about the Photos library.
number
number
number
number
boolean
string
boolean
boolean
boolean
boolean
string[]
boolean
string[]
Search the library with combinable filters. Returns photo summaries with UUIDs — use get-photo for full details on a specific match.
string
string
string[]
boolean
number[]