Tidyware

MCP server · App Intents · CLI

TwinSweep
para agentes de IA

Un asistente de IA puede usar cada función. Todo se ejecuta localmente en el Mac: la IA envía una solicitud, TwinSweep hace el trabajo y TwinSweep no sube nada.

Conecta con un clic

03

Claude Desktop / Cursor

Abre TwinSweep → Ajustes → IA → Conectar. Reinicia la app de IA.

Claude Code

Ajustes → IA → Copiar comando y luego pégalo en Terminal.

Siri y Atajos

Las acciones aparecen en la app Atajos, en TwinSweep.

Configuración MCP manual:

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

Herramientas

9

Los nombres y descripciones de las herramientas se muestran en inglés: exactamente lo que recibe tu asistente de IA.

HerramientaQué hace¿Modifica archivos?
find_duplicatesScan 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.No
get_scanShow all groups of a previous scan ("latest" or a scan_id). Read-only.No
trash_duplicatesMove 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.Sí
list_cleanupsPast cleanups (newest first) with how many files and whether they were undone. Read-only.No
undoPut 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.Sí
undo_lastSame as undo with no cleanup_id.Sí
find_photo_duplicatesFind 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).No
album_photo_duplicatesPut 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.Sí
delete_photo_duplicatesDelete 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.Sí

Ejemplos de solicitudes

05

Línea de comandos

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