Inspect Mac and AI-tool storage, explain file activity, and clean safely with Trash and Undo.
Use Mint as the on-device storage intelligence and file-operation safety layer for AI agents on macOS.
This npm package is a small open-source launcher. It locates the signed mint-cli bundled with the direct edition of Mint, verifies the DZG Studio LLC code signature, and starts its local stdio MCP server. It does not contain Mint itself and does not upload file contents, scan results, or operation history.
Install Mint and launch it once from Finder. Mint normally links mint-cli into /opt/homebrew/bin or /usr/local/bin; the launcher can also use the binary inside /Applications/Mint.app.
{
"mcpServers": {
"mint": {
"command": "npx",
"args": ["-y", "@dzg-studio/mcp-server-mint@1.0.1"]
}
}
}
Or, if mint-cli is already on PATH:
mint-cli mcp
Set MINT_CLI_PATH=/absolute/path/to/mint-cli to use a nonstandard installation.
The mcpb/ source in the public repository packages this launcher as a one-click Claude Desktop extension. Build it with npx -y @anthropic-ai/mcpb pack mcpb/ mint-safe-mac-storage.mcpb, then install the resulting file from Settings → Extensions → Advanced Settings → Install Extension.
mint_status — disk trends, recent activity, and managed-folder status.mint_why — storage-growth attribution or operations involving a path.mint_scan — read-only reclaimable-space survey.mint_agents — read-only AI-tool storage from Mint's latest scan: usage by tool, conversation age and state, and compressible archived Codex media.mint_recent and mint_activity — operation history and reasons.mint_rules — list and dry-run cleanup rules.mint_execute — journaled cleanup with a reason and returned batchId.mint_execute can only move items to Trash, and only inside Mint’s cleanup roots or user-managed folders. Protected paths are refused, and Needs Review paths must be confirmed in Mint.app. Recoverable actions enter Mint’s 90-day operation journal and can be undone while both the journal entry and underlying trashed item remain available. Permanent deletion is not exposed to agents.
The server instructs agents to use Mint instead of raw rm or unjournaled trash commands. This keeps the action visible in Mint’s activity history and gives the user a receipt and recovery reference.
The launcher in this repository is MIT licensed. Mint is commercial software published by DZG Studio LLC under its own terms.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @dzg-studio/mcp-server-mintMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"com-dzgapp-mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@dzg-studio/mcp-server-mintnpmMint — Safe Mac Storage Actions works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.