mail-attachments

Query a local SQLite index to find email attachments by filename, sender, and size.

5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/aashari/ai-agent-skills --skill mail-attachments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mail-attachments
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-mail/mail-attachments
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill mail-attachments

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Find attachments across all accounts and search by filename, extension, or sender to quickly locate documents, images, or any file sent by email.

Core Features & Use Cases

  • Search attachments by name, extension, sender, or mailbox
  • Filter by time range or size to narrow results
  • Output results in a structured table with Date, Sender, Subject, Filename, and Size
  • Use case: locate invoices, contracts, or receipts scattered across multiple mail accounts.

Quick Start

Ask the agent to locate all email attachments across accounts, filtered by filename or sender, within a date range and size window.

Frequently Asked Questions about mail-attachments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for email attachments across multiple accounts on macOS?

You can search email attachments across multiple macOS accounts by applying filters like filename, extension, sender, time range, and size. It queries a local SQLite index of your Mail data to return a structured table containing Date, Sender, Subject, Filename, and Size.

Can I filter email attachments by file size and date range?

Yes, you can filter email attachments by both file size and date range. Applying these filters to the local SQLite index narrows down the results, returning a structured table that matches your exact time and size criteria.

Does this email attachment search tool require any external dependencies?

No, this email attachment search tool requires no external dependencies. It operates independently using a local SQLite index to query your macOS Mail data, allowing you to retrieve emails with attachments without installing additional packages.

What is the best way to locate specific files like invoices sent to my email?

The best way to locate specific files like invoices sent to your email is to search by filename or extension. You can also filter by sender to pinpoint documents, images, or contracts scattered across multiple mail accounts and view them in a sortable table.

How does the local SQLite index work for finding mail attachments?

The local SQLite index works by querying your macOS Mail data to identify and retrieve emails with attachments. It processes your filter criteria—such as filename, extension, or sender—and returns matching results in a structured, sortable format.