iMessage MCP サーバー

⚠️免責事項 - 自己責任でご利用ください⚠️

このソフトウェアは現状のまま提供され、いかなる保証も付与されません。

AppleScript を使用して iMessage を送信し、連絡先を管理する MCP サーバー。

このサーバーは、AppleScriptを使用して、モデルコンテキストプロトコル（MCP）を介してmacOSのメッセージアプリと連絡先アプリと連携します。AppleScriptコマンドをTypeScriptサーバーにラップすることで、以下のことが可能になります。

• 連絡先の表示と検索

• 連絡先または電話番号にiMessageを送信する

• メッセージが送信されたときに確認を受け取る

特徴

リソース

• contacts://allから連絡先にアクセスします

• 名前、電話番号、メールアドレスなどの連絡先の詳細を表示します

• すべてのデータはローカルマシン上に保存されます

ツール

• search_contacts - 名前、電話番号、またはメールアドレスで連絡先を検索します

  • 検索クエリを受け取り、一致する連絡先を返します

  • 名前、電話番号、メールアドレスを検索

• send_message - iMessage を送信する

  • 受信者（電話番号/メール）とメッセージの内容を取得します

  • ローカルのメッセージアプリから送信

  • 確認またはエラーの詳細を返します

Related MCP server: Gmail MCP Server

インストール

1. 依存関係をインストールします:

npm install

2. サーバーを構築します。

npm run build

3. サーバーを使用するように Claude Desktop を構成します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/path/to/imessage-server/build/server.js"]
    }
  }
}

4. Claudeデスクトップを再起動します

5. 次のプロンプトが表示されたら権限を付与します。

   • 連絡先へのアクセス

   • メッセージアクセス

使用法

インストールすると、Claude Desktop と自然に会話できるようになります。

• 「連絡先を見せて」

• 「Marissaという名前の連絡先を検索」

• 「555-0123に10分以内に着くとメッセージを送ってください」

• 「アリスにiMessageを送って、ランチの予定がまだ合うかどうか聞いてみよう」

セキュリティノート

• すべての操作はローカルマシン上で実行されます

• 連絡先やメッセージのデータは外部サーバーに送信されません

• サーバーは連絡先とメッセージへのアクセスにmacOSの権限を必要とします

• メッセージはiMessageアカウントを通じて送信されます

発達

開発とデバッグには、MCP インスペクターを使用します。

npx @modelcontextprotocol/inspector node build/server.js

要件

• macOS（メッセージと連絡先の統合用）

• Node.js 18以上

• クロードデスクトップ

• アクティブなiMessageアカウント

トラブルシューティング

メッセージが送信されない場合は:

1. メッセージアプリがサインインされているか確認する

2. 権限が付与されていることを確認する

3. Claude Desktop ログでエラーを探します。

tail -f ~/Library/Logs/Claude/mcp*.log