TwinSweep
for AI agents

Every feature can be called by an AI assistant. Everything runs locally on the Mac — the AI sends a request, TwinSweep does the work, nothing is uploaded by TwinSweep.

Connect in one click

Claude Desktop / Cursor

Open TwinSweep → Settings → AI → Connect. Restart the AI app.

Claude Code

Settings → AI → Copy Command, then paste into Terminal.

Siri & Shortcuts

Actions appear in the Shortcuts app under TwinSweep.

Manual MCP config:

{
  "mcpServers": {
    "twinsweep": {
      "command": "/Applications/TwinSweep.app/Contents/MacOS/twinsweep",
      "args": ["mcp"]
    }
  }
}

Tools

Tool	What it does	Changes files?
`find_duplicates`	Scan folders for duplicate files (identical content) and optionally near-duplicate photos (resized / re-saved / slightly different). Changes nothing. Returns a scan_id, the space that could be freed, and each group with the copy to keep. Skips app bundles, photo libraries, hidden files, symlinks and iCloud files not downloaded.	No
`get_scan`	Show all groups of a previous scan ("latest" or a scan_id). Read-only.	No
`trash_duplicates`	Move the extra copies from a scan to the Trash, keeping one copy per group. Each file is re-checked first (still there, unchanged); changed files are skipped. Reversible with undo_last until the Trash is emptied. Ask the user before calling.	Yes
`undo_last`	Put back the files from the most recent trash_duplicates (from the Trash to their original folders). Never overwrites a file that now exists at the original path.	Yes

Example requests

“Clean up duplicate files in my Downloads folder”
“How many GB of duplicate photos are in my Pictures folder?”
“Keep the sharpest copy and remove the rest in this folder”
“Find duplicate videos larger than 1 GB”
“Undo the last clean-up”

Command line

CLI

twinsweep list
twinsweep find_duplicates --folders ~/Downloads --similar_images true

TwinSweepfor AI agents