---
title: "Use Tidy Mac with Cursor (MCP setup)"
description: "Add Tidy Mac’s MCP server to Cursor so its agent can check free disk space and what’s safe to clear before big builds or downloads. Read-only unless you Allow."
url: https://tidymac.space/integrations/cursor/
updated: 2026-10-30
---

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

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

Add Tidy Mac’s MCP server to Cursor so its agent can check free disk space and what’s safe to clear before big builds or downloads. Read-only unless you Allow.

Updated October 30, 2026By the Tidy Mac team

Setup in one line

Add a “tidymac” server whose command is Tidy Mac’s tidymac-mcp to ~/.cursor/mcp.json (or your project’s .cursor/mcp.json). Cursor’s agent can then check free space and what’s safe to clear.

## Setup

```
{
  "mcpServers": {
    "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 Cursor’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 Codex](/integrations/codex/)[Tidy Mac with Claude Desktop](/integrations/claude-desktop/)

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