find-duplicates
Locate groups of exact duplicate photos in your library, with per-member details like filename, date, and size for cleanup or audit.
Instructions
Use when: you want to find exact duplicates across the library — cleaning up after a double import, checking whether files were re-uploaded, or auditing before a migration/export. Returns: groupCount (total duplicate groups found), returned (groups in this response, capped at limit, default 100), and groups ordered newest-first — each with the member UUIDs plus per-member filename, date, size, dimensions, and movie flag. Use get-thumbnail on members to eyeball a group before acting on it. Do not use when: you're looking for near-duplicates or similar shots — Photos' fingerprint matches EXACT duplicates (identical image data) only; edited copies, resized versions, and burst siblings will NOT group. Safety: read-only. This server cannot delete photos — to act on duplicates, quarantine the extra copies into an album (create-album + add-to-album when writes are enabled, otherwise by hand in Photos.app) and review/delete inside Photos.app.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max duplicate groups to return (default 100; groupCount reports the total) | |
| library | No | Path to a .photoslibrary (default: system Photos library) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| groups | No | ||
| returned | No | ||
| groupCount | No |