imessage-mcp

MacのiMessageデータをClaude Desktop / Claude Codeに公開するローカルMCPサーバーです。 2つの機能を提供します：

1. 送信: AppleScript経由で Messages.app を操作

2. 読み取り: ~/Library/Messages/chat.db への直接的な読み取り専用SQLiteアクセス

すべてローカルで完結します。APIキーやネットワーク通信は一切ありません。

インストール

# 1. Clone / copy into ~/mcp-servers/imessage-mcp
cd ~/mcp-servers/imessage-mcp

# 2. Create a Python 3.11+ venv and install deps
python3.12 -m venv .venv
.venv/bin/pip install -e .

Related MCP server: imessage-mcp

権限（必須）

フルディスクアクセス — chat.db を読み取るために必要

システム設定 → プライバシーとセキュリティ → フルディスクアクセス → 以下をオンに切り替えます：

• 使用するターミナルアプリ（例: Terminal, iTerm2, Ghostty）、および

• Claude.app （Claude Desktopを使用する場合）

自動化 — Messages.app を操作するために必要

システム設定 → プライバシーとセキュリティ → 自動化 → 使用するターミナル / Claude.app を展開し、 メッセージ をオンに切り替えます。

Messages.appが起動しており、iMessageにサインインしている必要があります。

権限の設定が不足している場合、サーバーは開くべき設定パスをエラーメッセージとして表示します。

Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.json に以下をマージしてください：

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/YOUR_USERNAME/mcp-servers/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp.server"]
    }
  }
}

（venvのPythonへの絶対パスを指定するのが最も安全です。PATHの曖昧さを回避できます。YOUR_USERNAME を置き換えてください。）

ツール

日付は入出力ともにISO8601形式です。内部的には、Appleは message.date を2001年1月1日UTCからのナノ秒として保存しており、サーバーが双方向に変換します。

安全性の不変条件

• chat.db は sqlite3.connect("file:...chat.db?mode=ro", uri=True) で開かれます。 書き込みを試みると sqlite3.OperationalError: attempt to write a readonly database が発生します。

• send_imessage は受信者 / 本文 / サービスを 個別の osascript 引数 として渡すため、シェルインジェクションの心配はありません。

• 添付ファイルはメタデータ（ファイル名、mime_type、合計バイト数）のみを返します。バイナリデータは読み取られません。

制限事項

• 予約送信や遅延送信はサポートされていません。

• リッチメッセージや返信スレッドのメッセージは、テキストが attributedBody (NSKeyedArchive) に保存されている場合があります。埋め込まれたNSStringの抽出をベストエフォートで行いますが、特殊なペイロード（画像、タップバック、Apple Payなど）を含むメッセージは、body が空になりますが、メタデータは正しく表示されます。

• 到達確認: send_imessage は osascript の終了コードに基づいて成功を報告します。メッセージが実際に送信されたかを確認するには、数秒後に search_imessages または get_chat_messages を呼び出してください。

• macOS専用であり、サンドボックス化されたApp Storeアプリでは動作しません。

ローカル開発

.venv/bin/pytest -q