mcpField
A
apple-mail

apple-mail

github.com/mitsuhiko生産性3.2k252 回インストール5 週間前に更新
リポジトリ

apple-mail について

macOS の Apple Mail のローカルデータを検索・読み取り、添付ファイルを抽出するスキルです。Bash スクリプトで SQLite インデックスと `.emlx` ファイルを読み取り、メールデータは変更しません。

主な機能

  1. 01差出人・宛先・件名で検索
  2. 02日付・メールボックス・状態で絞り込み
  3. 03RFC822 形式でメールを読み取り
  4. 04添付ファイルを一時ディレクトリに抽出
  5. 05ローカルメールへの読み取り専用アクセス

活用シーン

  1. 01条件に合うメールの検索
  2. 02メールの読み取りとメタデータ確認
  3. 03メールから添付ファイルを抽出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mitsuhiko/agent-stuff --skill apple-mail

インストール後、Claude Code で/apple-mailを入力して読み込まれたか確認します。

同梱ファイルapple-mail.sh

詳細

Apple Mail スキル

macOS の Apple Mail のローカルストレージを検索し、読み取り、添付ファイルを抽出します。

ツール

apple-mail.sh — Apple Mail の SQLite エンベロープインデックスを検索し、ディスク上の .emlx ファイルを読み取る 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

検索オプション

フラグ説明
--from <addr>送信者アドレスの部分文字列
--to <addr>受信者アドレスの部分文字列
--subject <text>件名の部分文字列
--body <text>本文／要約テキストの部分文字列
--mailbox <name>メールボックス URL の部分文字列（例：INBOX、Sent、Trash）
--after <YYYY-MM-DD>指定日より後に受信したメール
--before <YYYY-MM-DD>指定日より前に受信したメール
--unread未読メッセージのみ
--flaggedフラグ付きメッセージのみ
--has-attachment添付ファイルがあるメッセージのみ
--limit <n>結果の最大数（デフォルト：20）

出力形式

  • search はヘッダー行付きのパイプ区切りテーブルを返します： id|sender|sender_name|subject|received|status|flagged|mailbox|attachments
  • info は構造化されたメタデータの各セクションを返します
  • read は未加工の RFC822 メールを標準出力に出力します
  • attachment は一時ディレクトリのパスを標準出力に、ファイル一覧を標準エラー出力に出力します

注意事項

  • メッセージ ID は Apple Mail 内部の ROWID（整数）で、id 列に表示されます
  • .partial.emlx ファイルにはヘッダーのみが含まれます（本文はダウンロードされていません）。read はこの点を警告します
  • 添付ファイルは /tmp/ 配下の一時ディレクトリにコピーされます。使用後は削除してください
  • body 検索はメール本文全体ではなく、summaries テーブル（Apple Mail のプレーンテキストプレビュー）を検索します
  • メールボックス URL はパーセントエンコードされています（例：%5BGmail%5D = [Gmail]、%20 = スペース）
  • デフォルトでは、削除済みのメッセージは検索対象から除外されます

コメント

Markdown 対応