К основному содержанию
скилл CX Codex

apple-mail · mitsuhiko — скилл для Claude Code: поиск писем и вложений

Ищите, читайте и скачивайте вложения из Apple Mail прямо из агента. Скилл работает с локальным хранилищем macOS, не трогая сами письма.

Apache-2.0 260 установок ★ 3 224 обновлён 2026-09-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mitsuhiko/agent-stuff --skill apple-mail -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/apple-mail/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/apple-mail/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

apple-mail sundial-org Управляет Apple Mail.app: ищет и читает письма, отправляет ответы, меняет статус сообщений и удаляет их. CX Codex +1 356установок apple-mail rbouschery Управляет Apple Mail на macOS через AppleScript: читает, ищет, отправляет и удаляет письма скриптами. Разбор входящих идёт без открытия почтового клиента. CX Codex +1 1 400установок Apple Mail MCP imdinu MCP-сервер для чтения и поиска писем Apple Mail. Ищет по телу письма по всей почтовой базе, а не только по последним сообщениям. CX Codex +1 ★ 76звёзд репо Apple Mail mgcrea MCP-сервер для macOS подключает локальное приложение Apple Mail к ИИ-агентам. Позволяет искать письма, читать цепочки и работать с почтой без передачи паролей IMAP во внешнюю сеть. CX Codex +1 ★ 6звёзд репо zoho-mail membrane Скилл для управления письмами, контактами, задачами, метками и календарями в Zoho Mail через Membrane CLI. CX Codex +1 181установок WireCat Mail WireCatLabs MCP-сервер WireCat Mail для Claude Code и Codex синхронизирует почтовый ящик в локальное хранилище и даёт ассистенту читать, искать, сортировать и отправлять письма через IMAP и SMTP. CX Codex +1 ★ 3звёзд репо email-management-expert sundial-org Скилл email-management-expert помогает разбирать почту в Apple Mail через протокол MCP и держать входящие пустыми. Пригодится при разборе завалов и сортировке писем по папкам. CX Codex +1 514установок Apple Shortcuts Integration Claude Office Skills Скилл Apple Shortcuts Integration создаёт и запускает Apple Shortcuts для автоматизации iOS и macOS, а также управляет напоминаниями, заметками и календарём. CX Codex +1 4 900установок

Из того же набора16

Весь набор →
ghidra Запускает headless-анализ исполняемых файлов через Ghidra, декомпилирует код в Си и извлекает строки или символы. Пригодится при исследовании прошивок и программ без графического интерфейса. CX Codex +1 706установок web-browser Скилл web-browser для Claude Code даёт агенту настоящий Chrome: переходы по страницам, клики, формы, скриншоты, разбор консоли и сетевых запросов. Живой браузер вместо парсинга HTML. CX Codex +1 685установок github Скилл для работы с GitHub через gh CLI: разбирает пул-реквесты, CI-прогоны, задачи и сложные запросы к API. CX Codex +1 507установок tmux Управляет интерактивными CLI-сессиями через tmux с изолированным сокетом. Запускает Python или lldb и читает их вывод. CX Codex +1 425установок uv Скилл подменяет pip, python и venv на uv — быстрый пакетный менеджер и рантайм для Python. Запускайте скрипты с uv run, добавляйте зависимости через uv add, используйте встроенные метаданные для автономных скриптов. CX Codex +1 251установок librarian Скилл librarian для Claude Code кэширует удалённые Git-репозитории в предсказуемом локальном пути и обновляет их при повторных обращениях. Используется для анализа внешнего кода. CX Codex +1 170установок sentry Скилл подключает ИИ-агента к API Sentry для разбора инцидентов. Помогает находить недавние ошибки, изучать стек вызовов, цепочки breadcrumbs и логи прямо в терминале. CX Codex +1 136установок native-web-search Скилл native-web-search для Claude Code запускает модель с поиском в интернете и возвращает краткую сводку с полными URL источников. Ищет актуальную информацию во время кодирования. CX Codex +1 134установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой