# TwinSweep > Clean up duplicate files and photos — even in your Photos library — in minutes, without deleting the wrong thing. Skips code projects and RAW+JPEG pairs, undo any clean-up. Pay once. Works with Claude, ChatGPT and Shortcuts. Native macOS app (14+), one-time purchase $19, 7-day free trial. All processing is local. AI assistants can control TwinSweep through a local MCP server (stdio), Apple Shortcuts / App Intents, or a CLI. ## Connect - MCP command: `/Applications/TwinSweep.app/Contents/MacOS/twinsweep mcp` - In the app: Settings → AI → Connect (Claude Desktop, Cursor) or Copy Command (Claude Code) ## Tools - `find_duplicates`: Scan folders for identical files and (optionally) near-duplicate photos. Changes nothing. Returns a scan_id, space that can be freed (by kind), and each group with the copy to keep and why. Skips system/app-data folders, app bundles, photo libraries, code projects, hidden files, symlinks and iCloud files not downloaded. - `get_scan`: Show all groups of a previous scan ("latest" or a scan_id). Read-only. - `trash_duplicates`: Move extra copies from a scan to the Trash. By default only identical copies; similar photos only with include_similar or when their groups are listed. At least one copy per group is always kept. Each file is re-checked first; network drives are never touched. Undo with undo. Ask the user before calling. - `list_cleanups`: Past cleanups (newest first) with how many files and whether they were undone. Read-only. - `undo`: Put files from a cleanup back from the Trash to their original folders (default: the most recent cleanup; or give cleanup_id from list_cleanups). Never overwrites a file that now exists at the original path. - `undo_last`: Same as undo with no cleanup_id. - `find_photo_duplicates`: Find identical and near-duplicate photos in the Apple Photos library (optionally one year or the last N days). Changes nothing. Uses the TwinSweep app (it asks for Photos access the first time). Returns a scan_id and groups with the photo to keep (favorites first, then highest resolution). - `album_photo_duplicates`: Put the extra photos from a photo scan into the album "TwinSweep – Duplicates" so the user can review and delete them in Photos. Never deletes anything. - `delete_photo_duplicates`: Delete the extra copies from a photo scan the standard Photos way: macOS shows its own confirmation, and photos go to Recently Deleted for 30 days (recoverable). By default only identical groups; similar groups only with include_similar or when listed. Favorites are never deleted. Ask the user first. ## Example requests - Clean up duplicate files in my Downloads folder - Find duplicate photos from 2025 in my Photos library and put them in an album - Scan my Pictures folder but skip the Clients folder - Find duplicate videos larger than 1 GB - Show my past clean-ups and undo the one from yesterday ## Links - Other languages: [English](https://tidyware.app/twinsweep/), [Tiếng Việt](https://tidyware.app/vi/twinsweep/), [Deutsch](https://tidyware.app/de/twinsweep/), [Français](https://tidyware.app/fr/twinsweep/), [Español](https://tidyware.app/es/twinsweep/), [Português (Brasil)](https://tidyware.app/pt-br/twinsweep/), [Italiano](https://tidyware.app/it/twinsweep/), [日本語](https://tidyware.app/ja/twinsweep/), [한국어](https://tidyware.app/ko/twinsweep/), [简体中文](https://tidyware.app/zh-hans/twinsweep/) - [Home](https://tidyware.app/twinsweep/) - [For AI agents](https://tidyware.app/twinsweep/for-ai-agents) - [Privacy](https://tidyware.app/twinsweep/privacy) - [Download](https://tidyware.app/twinsweep/#pricing)