local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables sending iMessages to contacts or phone numbers from your Mac, with confirmation when messages are sent.
Provides access to macOS Contacts app for viewing, searching, and managing contacts, including names, phone numbers, and email addresses.

iMessage MCP サーバー

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

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

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

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

連絡先の表示と検索
連絡先または電話番号にiMessageを送信する
メッセージが送信されたときに確認を受け取る

特徴

リソース

contacts://allから連絡先にアクセスします
名前、電話番号、メールアドレスなどの連絡先の詳細を表示します
すべてのデータはローカルマシン上に保存されます

ツール

search_contacts - 名前、電話番号、またはメールアドレスで連絡先を検索します
- 検索クエリを受け取り、一致する連絡先を返します
- 名前、電話番号、メールアドレスを検索
send_message - iMessage を送信する
- 受信者（電話番号/メール）とメッセージの内容を取得します
- ローカルのメッセージアプリから送信
- 確認またはエラーの詳細を返します

インストール

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

npm install

サーバーを構築します。

npm run build

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

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

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

Claudeデスクトップを再起動します
次のプロンプトが表示されたら権限を付与します。
- 連絡先へのアクセス
- メッセージアクセス

使用法

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

「連絡先を見せて」
「Marissaという名前の連絡先を検索」
「555-0123に10分以内に着くとメッセージを送ってください」
「アリスにiMessageを送って、ランチの予定がまだ合うかどうか聞いてみよう」

セキュリティノート

すべての操作はローカルマシン上で実行されます
連絡先やメッセージのデータは外部サーバーに送信されません
サーバーは連絡先とメッセージへのアクセスにmacOSの権限を必要とします
メッセージはiMessageアカウントを通じて送信されます

発達

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

npx @modelcontextprotocol/inspector node build/server.js

要件

macOS（メッセージと連絡先の統合用）
Node.js 18以上
クロードデスクトップ
アクティブなiMessageアカウント

トラブルシューティング

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

メッセージアプリがサインインされているか確認する
権限が付与されていることを確認する
Claude Desktop ログでエラーを探します。

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude Desktop が macOS の連絡先やメッセージアプリと対話できるようにするローカルサーバー。これにより、自然言語コマンドを使用して連絡先を検索したり、iMessage を送信したりできるようになります。

Related Resources

Reddit Discussion about this server

iMessage MCP Server