Messages

🚀 メッセージ検索ツール

このツールは、コマンドラインからApple Messages（iMessage/SMS）を曖昧検索および閲覧できます。Claude CodeのプラグインやMCPサーバーとしても使用できます。

✨ 主な機能

• 曖昧検索：タイポを許容してすべてのメッセージを検索できます。
• 最近のメッセージを閲覧：最近のメッセージ、連絡先、会話を閲覧できます。
• 連絡先名表示：電話番号ではなく連絡先の名前を表示します。
• コンテキスト表示：各検索結果の前後のメッセージを表示します。
• 送信者または日付範囲でのフィルタリング：送信者または日付範囲でメッセージを絞り込めます。
• 自動インデックス作成：新しいメッセージが検出されると自動的にインデックスが再構築されます。
• 複数のインターフェース：CLI、MCPサーバー、Claude Codeプラグインのいずれかで使用できます。

📦 インストール

Homebrew

brew install cardmagic/tap/messages

npm

npm install -g @cardmagic/messages

Claude Code Plugin（推奨）

プラグインとしてインストールすると、スキル（自動実行）とスラッシュコマンドが使用できます。

# マーケットプレイスを追加
claude plugin marketplace add cardmagic/ai-marketplace

# プラグインをインストール
claude plugin install messages@cardmagic

これにより以下の機能が利用できます。

• スキル：テキストやiMessageに関する質問をすると、Claudeが自動的にメッセージを検索します。
• スラッシュコマンド：/messages:search、/messages:recent、/messages:from などのコマンドが使えます。

MCP Server

プラグインを使用せずに直接MCPツールにアクセスする場合：

claude mcp add --transport stdio messages -- npx -y @cardmagic/messages --mcp

または、最初にグローバルにインストールする場合：

npm install -g @cardmagic/messages
claude mcp add --transport stdio messages -- messages --mcp

ソースからのインストール

git clone https://github.com/cardmagic/messages.git
cd messages
make install

# その後、プラグインまたはMCPサーバーとして追加します。
claude plugin marketplace add cardmagic/ai-marketplace
claude plugin install messages@cardmagic
# または
claude mcp add --transport stdio messages -- messages --mcp

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

このツールは、~/Library/Messages/chat.db のメッセージデータベースを読み取る必要があります。

1. システム設定 > プライバシーとセキュリティ > フルディスクアクセス を開きます。
2. + をクリックして、ターミナルアプリ（Terminal.app、iTerm、Warpなど）を追加します。
3. ターミナルを再起動します。

💻 使用例

CLI

閲覧コマンド

# 最近のメッセージを表示（誰からメッセージが来たか？）
messages recent

# 最近のアクティビティで連絡先をリストする
messages contacts --limit 10

# メッセージ数を含む会話をリストする
messages conversations

# 特定の人物からの最近のメッセージを表示
messages from "Mom"

# 完全な会話スレッドを表示
messages thread "John" --after 2024-12-01

検索コマンド

# メッセージを検索（最初の検索時に自動的にインデックスが構築されます）
messages search "coffee tomorrow"

# 送信者でフィルタリング
messages search "dinner" --from "Mom"

# 日付でフィルタリング
messages search "meeting" --after 2024-01-01

# 結果数とコンテキストを調整
messages search "project" --limit 20 --context 5

# インデックスの統計情報を表示
messages stats

# インデックスを強制的に再構築
messages index

検索オプション

Claude Code Plugin

プラグインとしてインストールすると、以下の機能が利用できます。 スキル（自動実行）：Claudeは、以下のような質問をすると自動的にメッセージを検索します。

• "Momが夕食について何と言った？"
• "最近誰からメッセージが来た？"
• "旅行に関するメッセージを見つけて"

スラッシュコマンド：

MCP Server

MCPサーバーとしてインストールすると、Claude Codeは以下のツールを使用できます。

手動MCP設定

Claude DesktopまたはVS Codeの場合、MCP設定に以下を追加します。

{
  "mcpServers": {
    "messages": {
      "command": "npx",
      "args": ["-y", "@cardmagic/messages", "--mcp"]
    }
  }
}

📚 詳細ドキュメント

動作原理

1. 自動インデックス作成：最初の検索時（または新しいメッセージが検出されたとき）に、ツールは自動的に以下のことを行います。
   • Apple MessagesのSQLiteデータベースを読み取ります。
   • SQLite FTS5の全文検索インデックスを構築します。
   • MiniSearchの曖昧検索インデックスを作成します。
   • アドレス帳から連絡先の名前を解決します。
2. 検索：両方のインデックスをクエリして、タイポを許容した最適な結果を得ます。
3. ストレージ：インデックスファイルは ~/.messages/ に保存されます。
   • index.db - SQLite FTS5データベース
   • fuzzy.json - MiniSearchインデックス
   • stats.json - インデックスの統計情報

📄 ライセンス

MIT