Apple Photos MCP
UnclaimedMCP server for Apple Photos - query, search, export, and inspect the macOS Photos library via Claude and other AI assistants, plus opt-in album/metadata write tools (read-only by default)
Install
claude mcp add apple-photos -s user -- npx -y apple-photos-mcpUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverTools (40)
addedAfter
string
addedBefore
string
addedInLast
string
album
string[]
burst
boolean
burstPhotos
boolean
description
string
detectedText
string
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
favorite
boolean
folder
string[]
fromDate
string
get-photo
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.
hidden
boolean
keyword
string[]
label
string[]
library
string
library-info
High-level stats about the Photos library.
limit
number
maxSize
number
minScore
number
minSize
number
movies
boolean
near
string
newestFirst
boolean
noKeyword
boolean
notFavorite
boolean
notHidden
boolean
person
string[]
photos
boolean
place
string[]
query
Search the library with combinable filters. Returns photo summaries with UUIDs — use get-photo for full details on a specific match.
title
string
toDate
string
uuid
string[]
video
boolean
year
number[]