Setup in one line
Run codex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp". Codex can then call Tidy Mac’s tools to see free space, where the space goes, big folders, duplicates and junk.
Setup
codex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"Or in ~/.codex/config.toml:
[mcp_servers.tidymac]
command = "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"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
| Tool | What it returns |
|---|---|
disk_overview | Free and used space, the Trash size, and whether this Mac’s licence is active. |
storage_breakdown | Where the space goes, as on Home: apps, your files, iCloud, Mail and Messages, System Data with its parts, macOS. |
biggest_folders | The biggest folders and files inside a folder, sized like Space Map (APFS clones counted once). |
find_files | Plain-English Spotlight search, like “videos over 1 GB” or “screenshots older than 30 days”. |
large_files | The biggest personal files in your home folder. |
duplicates | Groups of identical files (compared by content) and what removing the extra copies frees. |
junk | Caches, logs and leftovers the Clean screen would offer, each marked safe or worth a look, with sizes. |
apps | Installed apps with their size and when each was last opened. |
move_to_trash | Asks 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_trashopens a Tidy Mac pop-up over Codex’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.