macOS-only MCP server that exposes iMessage chat

imessage-mcp

iMessage の履歴を Claude に公開し、チャットごとの会話を Obsidian の保管庫にエクスポートする、macOS 専用の MCP サーバーです。whatsapp-mcp のパターンを踏襲しており、フック、launchd の実行間隔、保管庫の構成は同じです。

アーキテクチャ

• ~/Library/Messages/chat.db を直接読み取ります（SQLite、mode=ro&immutable=1 で開きます）。ブリッジデーモンは不要です。
• Whisper local-cpp によるボイスメモの文字起こしに対応しています（whatsapp-mcp 用にすでにインストール済みのモデルを再利用します）。
• ~/.claude/imessage-mcp/search.db に FTS5 の差分検索インデックスを作成します。
• チャットごとに、🤖 AI Chats/iMessage/<Contact>.md および 🤖 AI Chats/iMessage/Groups/<Group>.md にエクスポートします。
• AppleScript を使った送信経路に、下書き＋確認のパターンを採用しています（自動送信はしません）。

ツール一覧

読み取り： healthcheck、list_chats、list_messages、get_chat、search_contacts、search_messages、get_message_context、get_unread、get_thread、list_attachments、mark_chat_read、export_to_vault。

書き込み： send_message（AppleScript による送信を下書きします）、confirm_send（送信を確定します）。

インストール

Claude Code を開き、次のコマンドを貼り付けます。

/plugin marketplace add adelaidasofia/imessage-mcp
/plugin install imessage-mcp@imessage-mcp

次に、Claude.app にフルディスクアクセスを許可し（chat.db の読み取りに必要です）、Claude Code を再起動します。セットアップの詳細と環境変数については、SETUP.md を参照してください。

旧式のインストール方法（手動での .mcp.json 登録）

SETUP.md を参照してください。簡単に説明すると、Claude.app にフルディスクアクセスを許可し、uv sync を実行して、保管庫の .mcp.json に登録した後、Claude Code を再起動します。

保管庫へのエクスポート形式

---
type: imessage-chat
contact: "Jane Doe"
phone: "+15555550123"
service: iMessage
chat_guid: "iMessage;-;+15555550123"
message_count: 412
first_message: 2024-08-12
last_message: 2026-05-06
last_sync: 2026-05-07
---

日付ごとに本文セクションを作成し、リアクション、編集、返信、ボイスメモの文字起こし、添付ファイルへのウィキリンクを含めます。

関連する MCP

同じ作者による、同じアーキテクチャパターン（FastMCP、該当する場合は書き込み前に下書きと確認、Vault の自動エクスポート、MIT ライセンス）を採用したプロジェクトです。

• slack-mcp - 複数ワークスペースの Slack
• whatsapp-mcp - whatsmeow 経由の WhatsApp
• google-workspace-mcp - Gmail / Calendar / Drive / Docs / Sheets
• apollo-mcp - Apollo.io CRM とシーケンス
• substack-mcp - Substack の執筆と分析
• luma-mcp - lu.ma のイベント
• parse-mcp - markitdown / Docling / LlamaParse のルーター
• rescuetime-mcp - RescueTime の生産性データ
• graph-query-mcp - Vault のナレッジグラフクエリ
• investor-relations-mcp - シード資金調達パイプラインのトラッカー
• vault-sync-mcp - Vault の双方向同期

テレメトリー

このプラグインは、特定のマシンで Claude Code セッション中に初めて読み込まれた際、匿名のインストール通知を 1 回だけ myceliumai.co に送信します。

送信される情報：

• プラグイン名（例：slack-mcp）
• プラグインのバージョン（例：0.1.0）

送信されない情報：

• ユーザー識別子、氏名、メールアドレス、トークン、API キーは送信されません
• ファイルパス、メッセージ内容、作業に関する情報は一切送信されません
• 重複排除処理後に IP アドレスは保存されません

目的： 利用者が実際にインストールしているプラグインをメンテナーが把握し、よく使われているものに注力できるようにします。

オプトアウト： Claude Code の起動前に環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。通知済みのインストールでは ~/.mycelium/onboarded-<plugin> にセンチネルが作成されます。状態をリセットする場合は、このファイルを削除してください。

ライセンス

MIT。

---

Adelaida Diaz-Roa が開発しました。完全版のインストールまたはチーム版は diazroa.com をご覧ください。