---
title: "Tidy Mac MCP server: let AI agents read your Mac’s storage"
description: "Tidy Mac includes an MCP server, so Claude Code, Codex, Cursor and other agents can read your Mac’s storage. Nothing moves to the Trash until you click Allow."
url: https://tidymac.space/mcp/
updated: 2026-10-30
---

[Home](/) MCP server

# A storage MCP server for your AI agents

Tidy Mac includes an MCP server. Your agent reads the same accurate numbers you see, finds what’s big or old, and can ask to clear it. Nothing moves until you click Allow, in a pop-up right over the agent’s window.

Connect Tidy Mac to Claude Code`claude mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"`Or to Codex`codex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"`

## Connect in one line

Claude Code:

```
claude mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"
```

Codex:

```
codex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"
```

Cursor, Windsurf, Claude Desktop, Zed, VS Code and other MCP apps: add this to their `mcpServers` settings.

```
"tidymac": { "command": "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp" }
```

The server is a small program inside the app (`tidymac-mcp`) that your agent starts itself. It runs on your Mac and nothing leaves it. **Settings › AI agents** in Tidy Mac shows these commands with Copy buttons.

[**Claude Code**Setup →](/integrations/claude-code/)[**Codex**Setup →](/integrations/codex/)[**Claude Desktop**Setup →](/integrations/claude-desktop/)[**Cursor**Setup →](/integrations/cursor/)

Tool

What it returns

`disk_overview`

Free and used space, the Trash size, and whether this Mac’s licence is active.

`storage_breakdown`

Where the space goes, as on Home: apps, your files, iCloud, Mail and Messages, System Data with its parts, macOS.

`biggest_folders`

The biggest folders and files inside a folder, sized like Space Map (APFS clones counted once).

`find_files`

Plain-English Spotlight search, like “videos over 1 GB” or “screenshots older than 30 days”.

`large_files`

The biggest personal files in your home folder.

`duplicates`

Groups of identical files (compared by content) and what removing the extra copies frees.

`junk`

Caches, logs and leftovers the Clean screen would offer, each marked safe or worth a look, with sizes.

`apps`

Installed apps with their size and when each was last opened.

`move_to_trash`

Asks to move files to the Trash. You see a pop-up listing exactly what will move; nothing moves unless you click Allow.

## How move\_to\_trash works

1.  An agent calls `move_to_trash` with the files and a one-sentence reason.
2.  A Tidy Mac pop-up appears over the agent’s window, listing exactly what will move and how much it frees.
3.  Nothing moves unless you click **Allow**. Protected locations (system files, keychains, iCloud Drive, SSH keys, running apps’ data) are always refused.
4.  Allowed files go to the Trash. You can put them back from **History**.

To let agents only look, turn off **Agents can ask to move files to the Trash** in **Settings › AI agents** (it’s on by default). The other eight tools are read-only and work with any licence, with no extra setup.

![](/img/brand/tidy-128.png)

### Let Tidy Mac do this for you

See every part of your storage explained, and clear junk to the Trash with Undo. $9.99 $29 once, 2 Macs.

[Download](/download/TidyMac.dmg) [Buy Tidy Mac · $9.99 $29](/buy/)
