# Email Attachment Space Report MCP. AI Agent Connect

> Email Attachment Space Report MCP lets your AI client scan email metadata to identify storage hogs. Instead of digging through folders, you can ask your agent to find the largest files, group usage by file type, or list every attachment over a certain size. It turns messy attachment data into clear, actionable reports.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GeYh1AuBLSnZmEsn9ax1UW7sahs8QLzwEzx68J54/ai-agent-connect
- **Tags:** email, storage, attachments, metadata, analysis

## Description

You spend too much time hunting for the specific files that are pushing your mailbox over its limit. This MCP changes that by giving your AI client direct access to your email attachment metadata. You don't have to manually sort through thousands of messages to find out why your storage is full. Instead, you just ask your agent to run the numbers. 

You can get a high-level view of your total consumption or drill down into specific categories like PDFs or video files. If you need to clear space immediately, you can tell your agent to find every file larger than a specific megabyte threshold. It's a fast way to identify which senders or file types are responsible for the bulk of your storage usage. Once you have the data, you can decide what to delete or archive without the manual guesswork.

## Tools

### analyze_attachment_totals
This tool provides a high-level summary of how much total storage your attachments are consuming.

### filter_large_files
Use this to pull a specific list of all attachments that exceed a size limit you set.

### find_largest_attachments
This tool identifies the specific files that are using the most space in your mailbox.

### group_by_category
This tool breaks down your storage usage by file type or organizational labels.

## Prompt Examples

**Prompt:** 
```
How much total space are my email attachments using?
```

**Response:** 
```
The total storage usage for the provided attachments is 450 MB across 12 files.
```

**Prompt:** 
```
Show me the top 3 largest attachments.
```

**Response:** 
```
The largest attachments are: report.pdf (50 MB) from alice@example.com, video.mp4 (40 MB) from bob@example.com, and image.png (15 MB) from charlie@example.com.
```

**Prompt:** 
```
Which files are larger than 10 MB?
```

**Response:** 
```
There are 2 files larger than 10 MB: presentation.pptx (12 MB) and archive.zip (25 MB).
```

## Capabilities

### Storage Auditing
Your agent calculates the total footprint of all email attachments.

### Size Filtering
The AI pulls a list of files that cross a specific size threshold.

### Category Grouping
Your agent organizes usage data by file extension or label.

### Heavy File Identification
The tool finds the specific files consuming the most storage.

## Use Cases

### Mailbox Cleanup
Find and delete massive files to prevent hitting storage caps.

### Storage Auditing
Get a clear report on how much space different file types occupy.

### File Discovery
Locate specific large documents sent by certain contacts.

### Data Management
Group attachments by category to decide what to archive.

## Benefits

- Eliminates manual searching through email threads for large files.
- Provides instant breakdowns of storage by file type.
- Identifies specific storage hogs in seconds.
- Automates the identification of files exceeding size limits.

## How It Works

Connecting this MCP to your client gives your agent the ability to read attachment metadata.

1. Connect the MCP to your client through Vinkius.
2. Ask your agent a question about your email attachment storage.
3. The agent uses the relevant tool to scan your attachment metadata.
4. The agent presents a summarized report or list of files.

## Frequently Asked Questions

**What can this MCP do with my emails?**
It analyzes the metadata of your email attachments. It does not read the actual content of your emails, only the file size, type, and sender info.

**Which AI clients work with this MCP?**
You can use this with any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code.

**How do I find large files?**
You can simply ask your agent to find files larger than a specific size, and it will use the filter tool to give you a list.

**Can I see usage by file type?**
Yes, the group_by_category tool allows your agent to break down storage by file extension or label.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.

**What kind of data does this server process?**
It processes attachment records containing sender identity, timestamp, file size, file type, and organizational labels.

**How can I find the biggest files in my list?**
You can use the `find_largest_attachments` tool to retrieve a ranked list of the largest files.

**Can I group my storage usage by file extension?**
Yes, the `group_by_category` tool allows you to group data by either 'fileType' or 'label'.
