remove-from-album
Removes specified photos from an album, undoing misfiling or clearing reviewed items. Does not delete photos from the library.
Instructions
Use when: you want to take photos OUT of an album — undoing a mis-filing, or clearing reviewed items from a quarantine album. This removes ALBUM MEMBERSHIP only. Returns: the album AFTER the operation ({uuid, name, path} — note the uuid CHANGES when anything was removed), removedCount, removed, notInAlbum (requested UUIDs that weren't members — no-ops), albumRecreated, and previousAlbumUuid. Do not use when: you want to delete photos from the library — this server cannot delete photos at all (quarantine them in an album and review in Photos.app instead); or the photos aren't in the album (harmless, but pointless). Safety: WRITE tool — disabled unless APPLE_PHOTOS_MCP_ENABLE_WRITES=1 (run doctor to check). NEVER deletes photos from the library — removed photos stay in All Photos and every other album. Photos' AppleScript has no remove-from-album verb, so the album is REBUILT (same name and remaining photos): its UUID changes and any custom manual sort order is lost; re-fetch the album UUID from the response. When none of the UUIDs are members, nothing is rebuilt. Max 100 UUIDs per call. Drives Photos.app via AppleScript (requires macOS Automation permission). Writes target the library currently open in Photos.app.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | Photo UUID(s) to remove from the album (1–100) | |
| album | Yes | Album name or UUID (UUID-looking values try the id lookup first) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| album | No | ||
| removed | No | ||
| notInAlbum | No | ||
| removedCount | No | ||
| albumRecreated | No | ||
| previousAlbumUuid | No |