apple-mail · mitsuhiko — скилл для Claude Code: поиск писем и вложений
Ищите, читайте и скачивайте вложения из Apple Mail прямо из агента. Скилл работает с локальным хранилищем macOS, не трогая сами письма.
Apache-2.0 260 установок ★ 3 224 обновлён 2026-09-27
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a claude-codeЧто делает apple-mail
apple-mail даёт агенту доступ к SQLite индексу Apple Mail и позволяет искать письма по адресу отправителя и получателя, теме, телу, дате, папке и флагам. Можно вытащить полное письмо в формате RFC822 или только вложения.
Внутри — bash-скрипт apple-mail.sh, который работает только на чтение. Ищет письма командами вроде $TOOL search --from "peter@" --subject "dinner" --limit 5, показывает метаданные и содержимое конкретного письма через info и read, а вложения распаковывает в /tmp/ через attachment. Поддерживает фильтры по дате (--after, --before), флагам (--unread, --flagged) и наличию файлов (--has-attachment).
Рабочий результат поиска выдаётся таблицей с ID, отправителем, темой, датой и информацией о файлах. Полное письмо читается как RFC822 с заголовками и телом. Если письмо не полностью загружено (.partial.emlx), скрипт об этом предупредит.
Какие задачи решает
- найти письма по отправителю, получателю или теме за нужный период
- скачать вложения из писем и использовать их в коде
- прочитать исходный текст письма с заголовками
- отфильтровать непрочитанные или помеченные письма
- получить список всех папок почтового ящика с числом писем
Примеры запросов агенту
- Найди письма от [email protected] про ужин и скачай вложения
- Покажи все непрочитанные письма в INBOX с вложениями за февраль
- Прочитай полное содержимое письма 783660 с заголовками
Как установить apple-mail
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a claude-code2Вручную: положить файлы
~/.claude/skills/apple-mail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/apple-mail/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a codex2Вручную: положить файлы
.agents/skills/apple-mail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a cursor2Вручную: положить файлы
.cursor/skills/apple-mail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mitsuhiko/agent-stuff skills/apple-mail2Вручную: положить файлы
.github/skills/apple-mail/SKILL.md1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a gemini-cli2Командой платформы
gemini skills install https://github.com/mitsuhiko/agent-stuff --path skills/apple-mailВручную: положить файлы
.devin/skills/apple-mail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об apple-mail
Как установить apple-mail в Claude Code?
Выполни npx skills add mitsuhiko/agent-stuff --skill apple-mail -a claude-code, а затем проверь путь ~/.claude/skills/apple-mail/SKILL.md.
Что делает apple-mail?
Ищет, читает и скачивает вложения из локального хранилища Apple Mail на macOS. Работает с базой данных писем и RFC822 файлами, не меняя саму почту.
Для чего нужны флаги --unread и --has-attachment?
--unread вернёт только непрочитанные письма, --has-attachment — только те, у которых есть файлы. Их можно комбинировать с другими фильтрами.
Исходный текст
SKILL.md · Apache-2.0
--- name: apple-mail description: "Search, read, and extract attachments from Apple Mail's local storage. Query emails by sender, recipient, subject, body, date, mailbox, and flags. Read raw RFC822 messages and extract file attachments." --- # Apple Mail Skill Search, read, and extract attachments from Apple Mail's local storage on macOS. ## Tool `apple-mail.sh` — a bash script that queries the Apple Mail SQLite envelope index and reads `.emlx` files from disk. **Read-only** — it never modifies mail data. ## Quick Reference ```bash TOOL=~/Development/agent-stuff/skills/apple-mail/apple-mail.sh # Search emails $TOOL search --from "peter@" --subject "dinner" --limit 5 $TOOL search --after 2026-02-01 --has-attachment $TOOL search --body "invoice" --mailbox "INBOX" --unread $TOOL search --to "armin@" --before 2025-12-31 # Show message metadata, recipients, attachments, and summary $TOOL info 783660 # Read the raw RFC822 email (headers + body) $TOOL read 783660 # Extract attachments to a temp directory (prints the path) $TOOL attachment 783660 # all attachments $TOOL attachment 783660 "Rechnung.pdf" # specific file # List all mailboxes with counts $TOOL mailboxes ``` ## Search Options | Flag | Description | |------|-------------| | `--from <addr>` | Sender address substring | | `--to <addr>` | Recipient address substring | | `--subject <text>` | Subject substring | | `--body <text>` | Body/summary text substring | | `--mailbox <name>` | Mailbox URL substring (e.g. `INBOX`, `Sent`, `Trash`) | | `--after <YYYY-MM-DD>` | Received after date | | `--before <YYYY-MM-DD>` | Received before date | | `--unread` | Only unread messages | | `--flagged` | Only flagged messages | | `--has-attachment` | Only messages with attachments | | `--limit <n>` | Max results (default: 20) | ## Output Format - `search` returns pipe-delimited table with header row: `id|sender|sender_name|subject|received|status|flagged|mailbox|attachments` - `info` returns structured metadata sections - `read` outputs raw RFC822 email to stdout - `attachment` prints the temp directory path to stdout, file listing to stderr ## Notes - Message IDs are Apple Mail internal ROWIDs (integers), shown in the `id` column - `.partial.emlx` files contain headers only (body not downloaded); `read` warns about this - Attachments are copied to a temp directory under `/tmp/`; clean up when done - The `body` search queries the `summaries` table (Apple Mail's plaintext preview), not the full email body - Mailbox URLs are percent-encoded (e.g., `%5BGmail%5D` = `[Gmail]`, `%20` = space) - Deleted messages are excluded from search by default
© mitsuhiko · Apache-2.0 · mitsuhiko/agent-stuff
Похожие скиллы
Все скиллы по теме «Заметки, задачи и проекты» →Сначала — apple-mail от других авторов.