---
title: "Check Mac storage from Codex CLI (Tidy Mac MCP)"
description: "Connect Codex CLI to Tidy Mac’s MCP server with one command and let it read your Mac’s storage: free space, big folders, junk. Moves need your Allow."
url: https://tidymac.space/integrations/codex/
updated: 2026-10-30
---

[Home](/) [Integrations](/integrations/) Codex

# Tidy Mac + Codex: ask about your Mac’s storage

Connect Codex CLI to Tidy Mac’s MCP server with one command and let it read your Mac’s storage: free space, big folders, junk. Moves need your Allow.

Updated October 30, 2026By the Tidy Mac team

Setup in one line

Run `codex mcp add tidymac -- "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"`. Codex can then call Tidy Mac’s tools to see free space, where the space goes, big folders, duplicates and junk.

## Setup

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

Or in `~/.codex/config.toml`:

```
[mcp_servers.tidymac]
command = "/Applications/Tidy Mac.app/Contents/MacOS/tidymac-mcp"
```

The path assumes Tidy Mac is in Applications. Settings › AI agents in Tidy Mac shows the exact command for your Mac with a copy button.

## The tools your agent gets

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.

## Safety

-   Eight of the nine tools only read. Agents see sizes and names, and nothing leaves your Mac.
-   `move_to_trash` opens a Tidy Mac pop-up over Codex’s window listing exactly what will move. Nothing moves unless you click **Allow**.
-   Files only ever go to the Trash, and you can put them back from **History**. Protected locations (keychains, iCloud Drive, SSH keys, running apps’ data) are always refused.
-   Turn off **Agents can ask to move files to the Trash** in **Settings › AI agents** to let agents only look.

## Try asking

-   "How is my Mac's storage?"
-   "What are the biggest folders in my home folder?"
-   "What junk is safe to clear before I pull this Docker image?"

![](/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/)

## Keep reading

[Tidy Mac with Claude Code](/integrations/claude-code/)[Tidy Mac with Claude Desktop](/integrations/claude-desktop/)[Tidy Mac with Cursor](/integrations/cursor/)

Share:[X](https://x.com/intent/post?text=Tidy%20Mac%20%2B%20Codex%3A%20ask%20about%20your%20Mac%E2%80%99s%20storage&url=https%3A%2F%2Ftidymac.space%2Fintegrations%2Fcodex%2F)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Ftidymac.space%2Fintegrations%2Fcodex%2F&title=Tidy%20Mac%20%2B%20Codex%3A%20ask%20about%20your%20Mac%E2%80%99s%20storage)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Ftidymac.space%2Fintegrations%2Fcodex%2F&t=Tidy%20Mac%20%2B%20Codex%3A%20ask%20about%20your%20Mac%E2%80%99s%20storage)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Ftidymac.space%2Fintegrations%2Fcodex%2F)

#### On this page

[Setup](#setup)[Tools](#tools)[Safety](#safety)

**Tidy Mac**

See this on your own Mac in under a minute. $9.99 $29 once, 2 Macs.

[Download](/download/TidyMac.dmg)
