imessage-mcp

Claude CodeおよびClaude DesktopにiMessageデータを公開する読み取り専用のMCPサーバーです。連絡先名の自動解決機能付き。

セットアップ

1. インストール

cd ~/workspace/imessage-mcp
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

2. フルディスクアクセスの許可

このサーバーは ~/Library/Messages/chat.db および連絡先データベースを読み取る必要があります。サーバーを実行するアプリにフルディスクアクセスを許可してください：

1. システム設定 → プライバシーとセキュリティ → フルディスクアクセス を開く

2. Claude Code の場合：ターミナルアプリ（例：Terminal, iTerm2, Ghostty）を追加する

3. Claude Desktop の場合：Claudeアプリを追加する

3. Claude Codeの設定

~/.claude/settings.json に以下を追加します：

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

4. Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します：

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

Related MCP server: imessage-rich-search

ツール

list_chats

iMessageのチャットを最近のアクティビティ順に一覧表示します。

• limit (オプション、デフォルト50)：取得するチャットの最大数

get_messages

特定のチャットからメッセージを取得します。

• chat_id (必須)：list_chats から取得したチャット識別子

• limit (オプション、デフォルト50)：メッセージの最大数

• since (オプション)：ISO日付文字列 — この日付以降のメッセージのみを取得

search_messages

すべてのチャットからキーワードを含むメッセージを検索します。

• query (必須)：検索テキスト

• limit (オプション、デフォルト50)：結果の最大数

使用例

"グループチャットを一覧表示して" "Business Ideasチャットの最新メッセージを20件取得して" "メッセージから 'startup idea' を検索して"