TidyMacSetup in one line
Run codex mcp add tidymac -- "/Applications/TidyMac.app/Contents/MacOS/TidyMac" --mcp. Codex can then call TidyMac’s tools to see free space, hidden storage, history and suggestions.
Setup
codex mcp add tidymac -- "/Applications/TidyMac.app/Contents/MacOS/TidyMac" --mcpOr add it to ~/.codex/config.toml:
[mcp_servers.tidymac]
command = "/Applications/TidyMac.app/Contents/MacOS/TidyMac"
args = ["--mcp"]The path assumes TidyMac is in Applications. Settings › AI agents in TidyMac shows the exact command for your Mac with a copy button.
The tools your agent gets
| Tool | What it returns |
|---|---|
get_storage_overview | Free space, the storage bar, safely-freeable space, trend and forecast. |
list_categories | Every part of hidden storage with size, safety label and a one-line explanation. |
get_category | The full explanation of one category, plus its biggest items. |
get_space_history | Free space per day and every clean. |
what_grew | Which categories grew or shrank since N days ago. |
get_suggestions | TidyMac’s smart suggestions with the bytes involved. |
list_large_files | The biggest files in your own folders (never removed by TidyMac). |
list_other_big_folders | Big folders outside the library, with the owning app and whether it’s installed. |
request_cleanup | Only when you allow it: asks you to review a cleanup in TidyMac. Never cleans on its own. |
Safety
- Read-only by default. Agents see sizes, labels and explanations, never file contents.
request_cleanupexists only if you turn on Let agents ask to clean up in Settings. It opens TidyMac's review screen; you approve or deny.- Files only ever go to the Trash. Every agent call is listed in Settings.
Try asking
- "How is my Mac's storage?"
- "What grew this week?"
- "What's safe to clean before I pull this Docker image?"
Let TidyMac do this for you
Scan free, see every part of your storage explained, and clean only what’s safe. Everything goes to the Trash first.