# Download Folder Cleanup Plan AI Agent Connect

> Download Folder Cleanup Plan MCP gives your AI client the ability to audit your download directory. It identifies bit-for-bit duplicates, calculates how much space different file types occupy, and suggests specific groups of files to move to long-term storage. Instead of manually hunting through folders, you let your agent do the heavy lifting.

## Overview
- **Category:** storage
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_RfkmiDnytYXMWdZaWycknpKqj6TwU8NVdJUz7AwW/ai-agent-connect
- **Tags:** cleanup, duplicates, storage-analysis, file-organizer, automation

## Description

Stop letting your downloads folder turn into a digital junk drawer. This MCP gives your AI client the eyes it needs to see exactly what is eating up your disk space and where the clutter is hiding. You can ask your agent to scan the directory to find identical files that are wasting space or to group files by their extension and age. It doesn't just show you a list of files; it provides a strategy. You can see which file categories are the biggest offenders and get specific suggestions for files that are old enough to be moved to an archive. It turns a tedious manual cleanup task into a quick conversation with your agent.

## Tools

### get_review_folders
This tool identifies logical groups of files that need your attention based on specific criteria like size or age.

### calculate_space_by_category
Use this to see exactly how much disk space different file types are consuming.

### identify_duplicates
This tool finds groups of files that are bit-for-bit identical copies of each other.

### propose_archive_groups
This tool suggests specific bundles of files to move to long-term storage based on their age and type.

## Prompt Examples

**Prompt:** 
```
How much space is my media folder taking up?
```

**Response:** 
```
Your Media category is currently consuming 4.2 GB of space across 12 files.
```

**Prompt:** 
```
Find all my duplicate files.
```

**Response:** 
```
I found 3 groups of exact duplicates consisting of 5 files in total.
```

**Prompt:** 
```
Suggest some files I can archive that are older than 30 days.
```

**Response:** 
```
I suggest the following archive group: 'Old Documents from 2023' containing 'report_v1.pdf' and 'notes_old.txt'.
```

## Capabilities

### Duplicate Detection
Your agent finds exact copies of files to prevent redundant storage use.

### Storage Auditing
The AI calculates how much space is used by different file extensions.

### Smart Archiving
Your agent proposes groups of old files that are ready for long-term storage.

### File Grouping
The tool organizes files into logical sets for easier manual review.

## Use Cases

### Reclaiming Disk Space
Your agent finds large file types and duplicates that are clogging your drive.

### Project Archiving
The AI suggests which old project files can be moved to secondary storage.

### Folder Auditing
You use the agent to get a breakdown of what is actually inside your downloads folder.

### Duplicate Cleanup
The tool locates exact copies of files so you can delete the extras.

## Benefits

- Identifies bit-for-bit duplicates to reclaim wasted space.
- Groups files by type and age to make manual review faster.
- Provides actionable archive suggestions based on file age.
- Calculates storage consumption by file category.

## How It Works

Connecting this MCP to your client gives your agent direct access to analyze your local directory.

1. Connect the MCP to your preferred client like Claude or Cursor via Vinkius.
2. Ask your agent to scan your download directory.
3. Review the storage breakdown or duplicate lists provided by the agent.
4. Follow the archive suggestions to move old files out of your main folder.

## Frequently Asked Questions

**How does this MCP find duplicate files?**
It uses bit-for-bit comparison to ensure that files are exact copies before identifying them as duplicates.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client including Claude, Cursor, and Windsurf.

**Does this MCP delete files automatically?**
No, the tools provide analysis and suggestions, such as identifying duplicates or proposing archive groups, for you to act on.

**What kind of storage analysis can it do?**
It can calculate how much space is used by different file categories and group files by extension, year, or size.

**How do I get started?**
You subscribe through Vinkius, which hosts the MCP for you, and then connect it to your AI client with one click.

**How does the tool handle files I want to keep?**
Files marked with a 'keep' flag are excluded from duplicate detection and archive proposals to ensure your essential files are never suggested for deletion.

**Can I group files by their file extension?**
Yes, you can use `get_review_folders` with the 'extension' grouping parameter to see files organized by their type.

**What is an archive group?**
An archive group is a logical bundle of old files suggested by `propose_archive_groups` that can be moved to long-term storage in a single action.