Pruneo
Mac disk cleanup for AI agents: see what fills the disk, clean only what's safe, to a quarantine.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
https://github.com/Leanvitale/pruneo-mcp/releases/download/v1.0.0/pruneo-mcp.mcpbDocumentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Pruneo MCP server
Let your AI agent see what fills your Mac's disk and clean the safe part, always to a restorable quarantine.
Pruneo is a free Mac cleaner. Its MCP server is built into the app (pruneo mcp, stdio):
the agent can read a disk overview, list what each section holds with its risk level, and clean only what
Pruneo marks as safe and regenerable (caches, build outputs, old downloads…). Nothing is deleted: every cleanup goes
to Pruneo's quarantine (48 hours by default) and can be undone with one call.
- 🟢 Safe (regenerable): the agent may move it to quarantine.
- 🟡 Needs review: always refused. The person decides in the app.
- 🔴 Protected (SSH keys,
.git,.env, iCloud Drive, Mail, system files…): never touched. - The Trash, Time Machine snapshots and anything cleaned by a tool command (no undo) are refused too.
- Runs locally. No network, no account, no telemetry from the MCP server.
Tools
| Tool | What it does | Writes? |
|---|---|---|
get_disk_overview | Free and total disk space; per section, bytes that are safe, need review or are protected, and how much an agent may clean | No |
list_section_items | Items of one section, largest first: name, path (with ~), size, risk and whether an agent can clean it | No |
get_quarantine | Quarantine batches: id, size, original paths, expiry | No |
clean_safe_items | Moves the safe items of a section to quarantine. paths picks some, dry_run only previews. Returns what moved, bytes freed and how to undo | Moves to quarantine |
restore_from_quarantine | Puts every item of a batch back where it was | Restores |
Sections: junk, browsers, downloads, duplicates, large, leftovers, projects, xcode, node, python,
ai, docker, languages, editors, homebrew, android, devtools, creative, audio, music
(only the ones installed on your Mac show up), plus trash, timemachine, unknown and apps, which are read-only.
Install
Requires macOS 14 or later and Pruneo 1.1.0 or later:
download it free or brew install --cask leanvitale/tap/pruneo.
Claude Code
claude mcp add --scope user pruneo -- /Applications/Pruneo.app/Contents/Helpers/pruneo mcpor let Pruneo do it: pruneo mcp --install claude (also --install codex; plain --install prints every option).
Claude Desktop: download pruneo-mcp.mcpb from the latest release
and open it. The bundle is a tiny launcher that starts the MCP server of your installed Pruneo app.
Cursor, Windsurf and other clients:
{
"mcpServers": {
"pruneo": { "command": "/Applications/Pruneo.app/Contents/Helpers/pruneo", "args": ["mcp"] }
}
}Example prompts
- "How much space can I free on my Mac? Show me the biggest sections first."
- "Clean the safe Xcode and Node caches, but show me a dry run first."
- "What did you move to quarantine? Put back the last batch."
This repository
This repo holds the MCP bundle (bundle/: manifest, launcher, icon) and the registry metadata (server.json,
glama.json). The server itself ships inside Pruneo.app. ./build.sh packs dist/pruneo-mcp.mcpb and writes its
SHA-256 into server.json.
Questions or bugs: open an issue.
Questions fréquentes
Qu'est-ce que Pruneo ?
Mac disk cleanup for AI agents: see what fills the disk, clean only what's safe, to a quarantine.
Comment installer Pruneo ?
Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.
Faut-il une clé API pour Pruneo ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Pruneo est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Pruneo ?
Il est publié par Leanvitale. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.