{
  "name": "tidymac",
  "title": "Tidy Mac",
  "version": "1.0.0",
  "protocolVersion": "2025-06-18",
  "description": "Ask an AI agent what is filling this Mac's disk, System Data included, and move files to the Trash with the person's approval. Runs locally; nothing is uploaded.",
  "websiteUrl": "https://tidymac.space/",
  "documentation": "https://tidymac.space/mcp/",
  "transport": {
    "type": "stdio",
    "command": "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp",
    "args": []
  },
  "requirements": {
    "os": "macOS 14 Sonoma or later (Apple silicon or Intel)",
    "app": "Tidy Mac installed in /Applications (free download: https://tidymac.space/download/)",
    "pro": "move_to_trash needs Tidy Mac Pro; every other tool works on the free version"
  },
  "authentication": {
    "type": "none",
    "notes": "Local stdio server. move_to_trash shows a Tidy Mac pop-up and moves nothing unless the person clicks Allow. See https://tidymac.space/auth.md"
  },
  "install": {
    "claude-code": "claude mcp add tidymac -- \"/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp\"",
    "codex": "codex mcp add tidymac -- \"/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp\"",
    "mcpServers": {
      "tidymac": {
        "command": "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"
      }
    }
  },
  "tools": [
    {
      "name": "disk_overview",
      "title": "Disk overview",
      "description": "Free and used space on the startup disk, the Trash size, and whether Tidy Mac Pro is unlocked. Fast.",
      "readOnly": true
    },
    {
      "name": "storage_breakdown",
      "title": "Storage breakdown",
      "description": "Where the space goes, the way Tidy Mac's Home shows it: Apps, your files, iCloud, Mail and Messages, System Data (with its parts) and macOS. Accurate but takes about 30 seconds.",
      "readOnly": true
    },
    {
      "name": "biggest_folders",
      "title": "Biggest folders",
      "description": "The biggest folders and files inside a folder, sized the way Space Map does (APFS clones counted once). Takes a few seconds on big folders.",
      "readOnly": true
    },
    {
      "name": "find_files",
      "title": "Find files",
      "description": "Search files in plain English through Spotlight, e.g. \"videos over 1 GB\", \"pdf from chatgpt\", \"invoice last month\", \"screenshots older than 30 days\".",
      "readOnly": true
    },
    {
      "name": "large_files",
      "title": "Large files",
      "description": "The biggest personal files in the home folder (not app data or code dependencies).",
      "readOnly": true
    },
    {
      "name": "duplicates",
      "title": "Duplicate files",
      "description": "Groups of identical personal files (compared by content), with which copy Tidy Mac would keep and what removing the rest frees.",
      "readOnly": true
    },
    {
      "name": "junk",
      "title": "Junk to clean",
      "description": "Caches, logs and leftovers Tidy Mac's Clean screen would offer, each marked safe or review, with sizes.",
      "readOnly": true
    },
    {
      "name": "apps",
      "title": "Installed apps",
      "description": "Third-party apps with their size and when each was last opened.",
      "readOnly": true
    },
    {
      "name": "move_to_trash",
      "title": "Move to Trash",
      "description": "Moves files or folders to the Trash. The person sees a Tidy Mac pop-up with exactly what will move and must allow it; protected locations (system, keychains, iCloud Drive, SSH keys, running apps' data) are always refused. Everything can be put back from Tidy Mac › History. Needs Tidy Mac Pro.",
      "readOnly": false
    }
  ]
}