Tidy Mac + Claude Code: ask about your Mac’s storage

Connect Claude Code to Tidy Mac’s MCP server with one command and ask about your disk: free space, big folders, junk. Nothing moves until you click Allow.

Setup in one line

Run claude mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp", then ask Claude Code “How is my Mac’s storage?” It calls Tidy Mac’s read-only tools and answers with real numbers.

Setup

claude mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"

Then in Claude Code:

How is my Mac's storage? What's the biggest junk I can clear?

The path assumes Tidy Mac is in Applications. Settings › AI agents in Tidy Mac shows the exact command for your Mac with a copy button.

The tools your agent gets

ToolWhat it returns
disk_overviewFree and used space, the Trash size, and whether this Mac’s licence is active.
storage_breakdownWhere the space goes, as on Home: apps, your files, iCloud, Mail and Messages, System Data with its parts, macOS.
biggest_foldersThe biggest folders and files inside a folder, sized like Space Map (APFS clones counted once).
find_filesPlain-English Spotlight search, like “videos over 1 GB” or “screenshots older than 30 days”.
large_filesThe biggest personal files in your home folder.
duplicatesGroups of identical files (compared by content) and what removing the extra copies frees.
junkCaches, logs and leftovers the Clean screen would offer, each marked safe or worth a look, with sizes.
appsInstalled apps with their size and when each was last opened.
move_to_trashAsks to move files to the Trash. You see a pop-up listing exactly what will move; nothing moves unless you click Allow.

Safety

  • Eight of the nine tools only read. Agents see sizes and names, and nothing leaves your Mac.
  • move_to_trash opens a Tidy Mac pop-up over Claude Code’s window listing exactly what will move. Nothing moves unless you click Allow.
  • Files only ever go to the Trash, and you can put them back from History. Protected locations (keychains, iCloud Drive, SSH keys, running apps’ data) are always refused.
  • Turn off Agents can ask to move files to the Trash in Settings › AI agents to let agents only look.

Try asking

  • "How is my Mac's storage?"
  • "What are the biggest folders in my home folder?"
  • "What junk is safe to clear before I pull this Docker image?"

Let Tidy Mac do this for you

See every part of your storage explained, and clear junk to the Trash with Undo. $9.99 $29 once, 2 Macs.

Keep reading