English Français العربية

Pruneo

Official registry AI and agents

Mac disk cleanup for AI agents: see what fills the disk, clean only what's safe, to a quarantine.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/Leanvitale/pruneo-mcp/releases/download/v1.0.0/pruneo-mcp.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Pruneo MCP server
  2. Tools
  3. Install
  4. Example prompts
  5. This repository

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

ToolWhat it doesWrites?
get_disk_overviewFree and total disk space; per section, bytes that are safe, need review or are protected, and how much an agent may cleanNo
list_section_itemsItems of one section, largest first: name, path (with ~), size, risk and whether an agent can clean itNo
get_quarantineQuarantine batches: id, size, original paths, expiryNo
clean_safe_itemsMoves the safe items of a section to quarantine. paths picks some, dry_run only previews. Returns what moved, bytes freed and how to undoMoves to quarantine
restore_from_quarantinePuts every item of a batch back where it wasRestores

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 mcp

or 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.

Frequently asked questions

What is Pruneo?

Mac disk cleanup for AI agents: see what fills the disk, clean only what's safe, to a quarantine.

How do I install Pruneo?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does Pruneo need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Pruneo open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Pruneo?

It is published by Leanvitale. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.