Mint MCP server
{
"mcpServers": {
"mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint@latest"
],
"env": {
"MINT_CLI_PATH": "/path/to/directory"
}
}
}
}{
"mcpServers": {
"mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint@latest"
],
"env": {
"MINT_CLI_PATH": "/path/to/directory"
}
}
}
}{
"mcpServers": {
"mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint@latest"
],
"env": {
"MINT_CLI_PATH": "/path/to/directory"
}
}
}
}{
"servers": {
"mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint@latest"
],
"env": {
"MINT_CLI_PATH": "${input:mint_cli_path}"
}
}
},
"inputs": [
{
"id": "mint_cli_path",
"type": "promptString",
"description": "Mint cli path",
"password": true
}
]
}{
"mcpServers": {
"mint": {
"command": "npx",
"args": [
"-y",
"@dzg-studio/mcp-server-mint@latest"
],
"env": {
"MINT_CLI_PATH": "/path/to/directory"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @dzg-studio/mcp-server-mintversion 1.0.1
What it does
Mint is a macOS file storage intelligence and safety layer that exposes read-only disk analysis tools and journaled cleanup operations through MCP. It is for AI agents that need to inspect, explain, and safely manage local storage with full auditability and undo capability.
- Query disk usage trends, recent file operations, and storage growth attribution across managed folders and AI tools.
- Scan for reclaimable space and identify which files and caches can be safely cleaned.
- Move files to Trash with full operation journaling, reason tracking, and 90-day undo capability instead of permanent deletion.
Tools this server exposes
| Tool | Does |
|---|---|
| mint_status | Returns disk trends, recent activity, and managed-folder status. |
| mint_why | Explains storage-growth attribution or operations involving a specific path. |
| mint_scan | Performs a read-only reclaimable-space survey. |
| mint_agents | Returns read-only AI-tool storage data including usage by tool, conversation age, and compressible archived media. |
| mint_recent | Shows operation history and reasons. |
| mint_activity | Shows operation history and reasons. |
| mint_rules | Lists and dry-runs cleanup rules. |
| mint_execute | Performs journaled cleanup operations that move items to Trash with a reason and return a batchId for tracking. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.