A storage MCP server for your AI agents

Tidy Mac includes an MCP server. Your agent reads the same accurate numbers you see, finds what’s big or old, and can ask to clear it. Nothing moves until you click Allow, in a pop-up right over the agent’s window.

Connect Tidy Mac to Claude Codeclaude mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"Or to Codexcodex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"

Connect in one line

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"

Cursor, Windsurf, Claude Desktop, Zed, VS Code and other MCP apps: add this to their mcpServers settings.

"tidymac": { "command": "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp" }

The server is a small program inside the app (tidymac-mcp) that your agent starts itself. It runs on your Mac and nothing leaves it. Settings › AI agents in Tidy Mac shows these commands with Copy buttons.

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.

How move_to_trash works

  1. An agent calls move_to_trash with the files and a one-sentence reason.
  2. A Tidy Mac pop-up appears over the agent’s window, listing exactly what will move and how much it frees.
  3. Nothing moves unless you click Allow. Protected locations (system files, keychains, iCloud Drive, SSH keys, running apps’ data) are always refused.
  4. Allowed files go to the Trash. You can put them back from History.

To let agents only look, turn off Agents can ask to move files to the Trash in Settings › AI agents (it’s on by default). The other eight tools are read-only and work with any licence, with no extra setup.

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.