Skip to content

Connect an AI agent

AI agents such as Claude Code, Codex, Cursor and Claude Desktop can ask Uncram what fills your disk and propose cleanups. This is part of Uncram Pro and off by default.

Choose what agents see

Open Settings › Agents:

  • Off: agents can't use Uncram.
  • Summary: categories, sizes and what each kind of item is. No folder or file names.
  • Summary and folder paths: also items with paths inside your home folder. Agents can also propose files and folders they choose themselves, each with a reason.

No level shows what is inside Desktop, Documents, Downloads, Mail, Messages or Photos. What an agent sees is sent to the company that runs its model.

Connect Claude Code

Run this in Terminal:

claude mcp add --scope user uncram -- "/Applications/Uncram.app/Contents/Helpers/uncram-mcp"

Settings shows the setup for Codex, Cursor and Claude Desktop, with a Copy button for each.

Review a proposal

When an agent proposes a cleanup, a banner says who proposes what. Choose Review… to open the usual sheet, with the agent's message quoted. Uncheck anything and confirm, or choose Decline. One proposal waits at a time and expires after 24 hours.