Apple Photos MCP
未认领MCP 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)
安装
claude mcp add apple-photos -s user -- npx -y apple-photos-mcp工具（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[]