doctor
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
How to use it
doctor is exposed by the Apple Photos MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the doctor 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
boolean
string[]
string
Get full metadata for a single photo by UUID.
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.
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[]