mac_messages_mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

Smart message delivery: auto-selects iMessage for Apple, SMS/RCS for Android
Read messages with time-based filtering, contact search, and fuzzy matching
iMessage availability check before sending
Attachment processing and group chat support
macOS 11+, Python 3.10+ — available via pip or uvx

ライブデモ

実際の動作

mac-messages-mcp-2.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mac-messages-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "mac-messages-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/carterlasalle/mac_messages_mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add mac-messages-mcp-2 -- TODO 'See README: https://github.com/carterlasalle/mac_messages_mcp'

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： mac_messages_mcp

How to search your iMessage history with AI assistance

👤 Mac users who want to find specific conversations or information ⏱ ~5 min beginner

使うタイミング： You need to find a message from weeks ago but can't remember who sent it or when.

前提条件

Full Disk Access granted — System Settings → Privacy & Security → Full Disk Access → add Terminal or your MCP host
mac-messages-mcp installed — uvx mac-messages-mcp or uv pip install mac-messages-mcp

フロー

Search messages

Search my messages for conversations about 'dinner reservation' in the last 2 weeks. Show who sent them and the full context.✓ コピーしました

→ Matching messages with sender, timestamps, and surrounding context
Get recent from a contact

Show me my last 20 messages with John Smith.✓ コピーしました

→ Conversation thread with timestamps

結果： Found the specific message or conversation you were looking for.

注意点

Full Disk Access not granted — The MCP server can't read the Messages database without this permission. Grant it in System Settings.

Send messages to contacts using Claude

👤 Mac users who want to send messages hands-free ⏱ ~2 min beginner

使うタイミング： You want to compose and send messages through Claude.

前提条件

mac-messages-mcp with Full Disk Access — Set up as above

フロー

Check iMessage availability

Can I reach +1-555-0123 via iMessage?✓ コピーしました

→ Availability status (iMessage or SMS)
Send a message

Send a message to Mom saying 'Running 15 minutes late, see you soon!'✓ コピーしました

→ Message sent confirmation with delivery method

結果： Message delivered via the appropriate channel.

注意点

Contact names may be ambiguous — Use phone numbers or email addresses for precise targeting

組み合わせ

他のMCPと組み合わせて10倍の力を

mac-messages-mcp-2 + filesystem

Export message conversations to text files for backup

Export my last month's messages with the 'Family' group chat to ~/messages-backup/family.txt.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング
send_message	recipient: str, content: str	Send a message via iMessage or SMS
get_recent_messages	contact?: str, limit?: int, time_range?: str	Retrieve recent messages with optional filters
check_imessage_availability	recipient: str	Check if a recipient can receive iMessage

コストと制限

運用コスト

APIクォータ: N/A — reads local macOS Messages database
呼び出しあたりのトークン: 200–1000 tokens per query
金額: Free — standard iMessage/SMS rates apply for sending
ヒント: Use time-based filters to limit search scope and reduce token usage.

セキュリティ

権限、シークレット、影響範囲

最小スコープ： Full Disk Access on macOS

認証情報の保管： No credentials needed — accesses local Messages database directly

データ送信先： Reads from local ~/Library/Messages/chat.db. Sending goes through macOS Messages framework.

Full Disk Access grants broad file access. The MCP server only reads the Messages database, but the permission itself is powerful.
Sending messages acts as you — all messages appear from your account.
Message history contains sensitive personal data. Ensure your AI interactions are private.

トラブルシューティング

よくあるエラーと対処法

Permission denied reading Messages database

Grant Full Disk Access to Terminal (or your MCP host app) in System Settings → Privacy & Security → Full Disk Access.

確認： ls ~/Library/Messages/chat.db

Contact not found

Use phone number or email instead of display name. Fuzzy matching may not find all contacts.

確認： Try with the exact phone number

Message fails to send

Ensure Messages.app is configured and signed into your Apple ID. The MCP server uses macOS frameworks to send.

確認： Try sending a message manually from Messages.app

代替案

mac_messages_mcp 他との比較

代替案	代わりに使う場面	トレードオフ
applescript-mcp	You want broader macOS control beyond just Messages	Can do everything plus more, but with full system access risks

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る