TidyMacSetup in one line
Add a “tidymac” server to ~/.cursor/mcp.json (or your project’s .cursor/mcp.json) with TidyMac’s path and the --mcp argument. Cursor’s agent can then check free space and what’s safe to clear.
Setup
{
"mcpServers": {
"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.