Burrow MCP Server: Setup for Claude Code, Cursor and Other Apps

• Shows your Mac's current CPU, memory, disk and network

  Returns the latest status reading from Burrow, including the top processes and a 0 to 100 health score. Use it before reasoning about how your Mac is doing right now.

  Try: “What is my CPU and memory doing right now?”

  Read · burrow_snapshot

• Checks if your Mac is healthy

  Runs health checks for Full Disk Access, memory pressure, disk headroom, disk health and Time Machine backup age, and reports ok, warn or fail for each. It does not cover security settings like the firewall or FileVault.

  Try: “Is anything wrong with my Mac?”

  Read · burrow_doctor

• Lists the apps using the most CPU lately

  Ranks running processes by their peak CPU use over a time window you choose, to explain a hot or loud Mac.

  Try: “Which processes used the most CPU in the last 30 minutes?”

  Read · burrow_top_processes

• Ranks apps by CPU or memory over a longer period

  Ranks processes by total CPU time, peak CPU, average CPU or peak memory over a window, which suits questions about battery drain or heat over the day.

  Try: “What has been draining my battery since this morning?”

  Read · burrow_process_usage

• Shows how CPU, memory and disk changed over time

  Returns a time-series slice from Burrow's local history, so the assistant can spot trends instead of one reading.

  Try: “Has my memory use crept up since noon?”

  Read · burrow_history

• Shows what changed on your Mac since earlier

  Compares a past snapshot with now and reports which processes entered or left the top list and how much free space changed.

  Try: “My Mac got slow in the last hour. What changed?”

  Read · burrow_diff

• Predicts when your disk will fill up

  Projects the number of days until a disk is full from the free-space history. It returns nothing useful if the trend is flat or growing.

  Try: “When will my disk fill up at this rate?”

  Read · burrow_disk_forecast

• Writes a weekly Mac health digest

  Produces a Markdown report over the days you choose, with the disk forecast, top energy users and a summary of past cleanups.

  Try: “Give me a weekly digest of how my Mac is doing.”

  Read · burrow_report

• Flags apps behaving unusually compared with their own past

  Finds processes whose CPU use over the last 24 hours is well above their own 14-day baseline. A process that always runs hot is not flagged.

  Try: “Is anything on my Mac behaving unusually?”

  Read · burrow_anomalies

• Lists which programs are listening on network ports

  Lists listening TCP and UDP ports with the process that owns each. It only reads, so freeing a port means you stop the process yourself.

  Try: “What is using port 3000?”

  Network · burrow_ports

• Checks whether Burrow is recording data

  Shows what data Burrow holds, how many rows, how fresh it is and the sample interval, which helps when other tools return empty results.

  Try: “Is Burrow actually recording data?”

  Read · burrow_info

• Shows what your assistant has already changed on your Mac

  Reads Burrow's audit log of every change an agent attempted, with the arguments, whether it was a dry run, the outcome and how long it took.

  Try: “What have you already cleaned on my Mac?”

  Read · burrow_agent_audit

• Lists past cleanups and the space they freed

  Shows earlier clean, optimize, purge and uninstall sessions with the bytes freed and how many items were removed, trashed, skipped or failed.

  Try: “How much space have I reclaimed with Burrow?”

  Read · burrow_cleanup_history

• Shows exactly which files Burrow removed

  Lists the paths Burrow trashed or removed, newest first, with the action and status of each.

  Try: “Did Burrow remove my old Xcode cache?”

  Files · burrow_deleted_files

• Finds what is taking up space in a folder

  Returns the children of a folder ranked by size, optionally going deeper into the biggest subfolders. Scanning a home folder or the Library folder can take minutes.

  Try: “What is taking up space in my Downloads folder?”

  Files · burrow_analyze

• Lists your installed Mac apps with their sizes

  Returns each app's name, bundle ID, source and size. The assistant calls it before any uninstall because the bundle ID is what uninstall needs.

  Try: “Which apps do I have installed, biggest first?”

  Files · burrow_list_apps

• Finds duplicate files in folders

  Reports groups of identical files across the folders you give it. It only reports and deletes nothing.

  Try: “Do I have duplicate files in my Documents folder?”

  Files · burrow_dupes

• Finds near-duplicate photos

  Reports groups of visually similar PNG and JPEG images in a folder. It only reports and deletes nothing.

  Try: “Find near-duplicate photos in my Pictures folder.”

  Files · burrow_photos

• Finds leftovers from apps you already uninstalled

  Lists files in a folder that belong to no installed app. You can pass the list of installed bundle IDs to override auto-detection.

  Try: “What leftovers did uninstalled apps leave in my Library?”

  Files · burrow_orphans

• Shows which apps are using your network

  Reports network use per app, to answer which program is sending or receiving data right now.

  Try: “Which app is using my network right now?”

  Network · burrow_net

• Previews what a set of cleanup rules would target

  Takes a folder of community cleanup rules and lists each rule's paths with its risk level and whether they exist. No rules ship with the app and nothing is deleted.

  Try: “Preview what the cleanup rules in this folder would target.”

  Files · burrow_rules_dryrun

• Lists apps sitting in your Trash

  Finds .app bundles currently in the Trash, so you can sweep the leftovers they may have left behind.

  Try: “Did I trash any apps whose leftovers I should sweep?”

  Files · burrow_sentinel

• Estimates how much space thinning a program would save

  Analyses a Mach-O binary and estimates the space you would reclaim by removing unused architecture slices. It is an estimate only and never rewrites the file.

  Try: “How much space would thinning this binary save?”

  Files · burrow_slim_check

• Cleans caches, logs and temp files, to the Trash

  Previews by default. A real run needs confirm set to true and the Let agents run cleanups switch in Burrow's Settings, and it moves caches, logs, temp files and leftovers to the Trash. The scan can take minutes on a full disk.

  Try: “Show me what a cleanup would remove, without doing it.”

  Delete · burrow_clean

• Refreshes caches and runs safe Mac maintenance

  Previews by default. A real run refreshes caches and services using the same gate as clean.

  Try: “Preview the maintenance tasks you would run.”

  Runs code · burrow_optimize

• Removes an app and its data

  Previews by default. A real run needs confirm plus both opt-in switches, and removes the app and its per-app files under your Library folder to the Trash, or deletes them outright if permanent is true. Homebrew apps are removed with brew uninstall --cask --zap, with no Trash.

  Try: “Preview what uninstalling Slack would remove.”

  Delete · burrow_uninstall

• Previews build artifacts such as node_modules you could delete

  Over MCP this only returns the preview list of developer build artifacts. The real purge runs from the Burrow app.

  Try: “List the node_modules folders I could purge.”

  Files · burrow_purge

• Previews leftover installer files you could delete

  Over MCP this only returns the preview list of leftover .dmg and .pkg installers. The real removal runs from the Burrow app.

  Try: “Which old installers are taking up space?”

  Files · burrow_installer

Watch out for

• Cleaning and uninstall tools can delete once you opt in

  With the Settings switches on, burrow_clean and burrow_uninstall can remove files. Removals go to the Trash unless permanent is true, and that cannot be undone. Leave the switches off unless you want that. github.com

• Homebrew app removal skips the Trash

  For apps installed with Homebrew, burrow_uninstall runs brew uninstall --cask --zap, which also deletes data the preview cannot list. Check the preview before you approve it. github.com

• The Burrow app sends anonymous analytics

  The app reports anonymous usage and crash data to PostHog and Sentry, with an opt-out. Check its settings if you want this off. github.com

Security advisories