carterlasalle/mac_messages_mcp

ローカルMCPクライアントからmacOSメッセージを読み込み、検索し、送信してください。

クイックスタート ·利用可能なツール ·エージェントスキル ·コマンドラインインターフェース ·セキュリティ ·チェンジログ

Claude、Codex、カーソル、VS Code、または任意のローカルMCPクライアントを使って検索、閲覧、 macOSのメッセージアプリからメッセージを送信してください。

Mac Messages MCPはMac上でローカルで動作します。メッセージと連絡先を開きます データベースは読み取り専用で、クライアントが要求し使用するデータのみを返します 自動化 Messages.app クライアントが明示的に送信ツールを呼び出した場合にのみ行われます。

[!重要] このサーバーはmacOS専用です。メッセージの読み込みにはフルディスクが必要です アクセス。送信にはMacがメッセージにサインインし、さらに メッセージの自動化を>アプリを起動します。

仕組み

クライアントが読み取るすべてのデータは、開いたローカルのSQLiteデータベースから来ています 読み取り専用。機械から出るすべてのデータは Messages.app を通じて送られます。 明示的な送信ツール呼び出しの下で行われます。メッセージおよび連絡先由来のテキストは次のように囲まれています。 モデルに戻る途中で信頼できないデータ。

能力

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool.

[!IMPORTANT] This server is macOS-only. Reading messages requires Full Disk Access. Sending requires a Mac signed into Messages plus permission for the launching app to automate Messages.

How it works

flowchart LR
    A[MCP client] -->|stdio| B[mac-messages-mcp]
    B --> C{Tool call}
    C -->|read tools| D[(chat.db read-only)]
    C -->|read tools| E[(AddressBook read-only)]
    C -->|send tools| F[Messages.app]
    F --> G[Recipient]
    D --> H[Untrusted-output boundary]
    E --> H
    H --> A

Everything the client reads comes from the local SQLite databases, opened read-only. Everything that leaves the machine goes out through Messages.app, under an explicit send tool call. Message- and contact-derived text is fenced as untrusted data on the way back to the model.

Capabilities