Trash MCP Server

A desktop MCP service that scans for and removes junk files to keep your system clean and optimized.

Local serverstdioTypeScript

What is the Trash MCP Server?

A desktop MCP service that scans for and removes junk files to keep your system clean and optimized.

What it actually does

A desktop MCP service providing tools to scan, analyze, and clean junk files, primarily optimized for macOS.

  • Cross-Platform: — (Planned) Windows, macOS, Linux support
  • Intelligent Scanning: — Identifies various types of junk files (caches, logs, temp files, etc.)
  • Selective Cleaning: — Tools for cleaning specific areas like application caches, temp files, and application remnants
  • VS Code Extension Management: — Tools to find and clean old/unused VS Code extensions
  • Filesystem Utilities: — Tools for directory analysis, file finding, size calculation, deletion, etc
  • System Information: — Basic OS detection

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
macOSWarningDisplays a warning if run on a non-macOS system.
cleanAppCachesCleans various application caches (user cache, saved app state).
cleanTempFilesCleans system temporary files.
cleanAppRemnantsScans for and cleans configuration/cache files left by uninstalled applications.
smartCleanSystemPerforms system cleaning based on predefined levels (targets common junk locations).
cleanVSCodeExtensionsCleans outdated versions of VS Code (and compatible editors like VSCodium, Cursor) extensions.
reportVSCodeExtensionsGenerates a report listing outdated VS Code extensions that can be cleaned.
findLargeFilesFinds files exceeding a specified size within a directory.
scanFullSystemScans the entire system's file structure (respecting exclusions) to report on space usage.
scanDirectoryAnalyzes the contents and size distribution within a specific directory.
getFolderSizeCalculates and returns the total size of a folder.
listDirectoryLists the files and subdirectories within a specified path.
findFilesSearches for files matching a specific pattern (wildcards supported) within a directory.

How to install the Trash MCP Server

{
  "mcpServers": {
    "trash-cleaner": {
      "command": "npx",
      "args": ["-y", "@childhoodandy/trash-cleaner-mcp-server"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Trash to macOSWarning.”
  • “Use Trash to cleanAppCaches.”
  • “Use Trash to Options.”

Frequently asked questions

Most cleaning tools (`cleanAppCaches`, `cleanTempFiles`, `cleanAppRemnants`, `smartCleanSystem`) are designed and tested specifically for macOS. Cross-platform support for Windows and Linux is planned. The server can report the operating system via `getSystemType`.