mac-messages-mcp

Mac メッセージ MCP

MCP (Multiple Context Protocol) を使用して macOS メッセージアプリと対話するための Python ブリッジ。

$tex を搭載した Mac コンピューターの図\_FvvnmbaBTFeKy6F2GMlLqA\_IfCBMgJARcia1WTH7FaqwA$

特徴

macOS メッセージアプリから最近のメッセージを読む
連絡先別にメッセージをフィルタリング
iMessageで新しいメッセージを送信する
API経由でメッセージにアクセスする

前提条件

macOS（macOS 11以降でテスト済み）
Python 3.10以上
UVパッケージマネージャー

uvのインストール

Mac を使用している場合は、Homebrew を使用して uv をインストールします。

brew install uv

それ以外の場合は、 uv Web サイトのインストール手順に従ってください。

⚠️ uvをインストールする前に先に進まないでください

インストール

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

⚠️ このアプリケーションでは、端末またはアプリケーションがメッセージデータベースにアクセスするために**、フルディスクアクセス**権限が必要です。

フルディスクアクセスを許可するには:

システム環境設定/設定>セキュリティとプライバシー/プライバシー>フルディスクアクセスを開きます
変更するにはロックアイコンをクリックしてください
ターミナルアプリ（Terminal、iTerm2など）またはClaude Desktop/Cursorをリストに追加します
許可を与えた後、端末またはアプリケーションを再起動してください

統合

クロードデスクトップ統合

Claude >設定>開発者>設定の編集> claude_desktop_config.jsonに移動します。
次の構成を追加します。

{
    "mcpServers": {
        "messages": {
            "command": "uvx",
            "args": [
                "mac-messages-mcp"
            ]
        }
    }
}

カーソル統合

「カーソル設定」 > **「MCP」**に移動し、これをコマンドとして貼り付けます。

uvx mac-messages-mcp

⚠️ MCP サーバーのインスタンスを 1 つだけ実行します (Cursor または Claude Desktop のいずれか)。両方実行しないでください。

オプション1: PyPIからインストールする

uv pip install mac-messages-mcp

オプション2: ソースからインストールする

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

使用法

モジュールとして

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

コマンドラインツールとして

# Run the MCP server directly
mac-messages-mcp

発達

バージョン管理

このプロジェクトではセマンティックバージョニングを使用しています。バージョニングシステムの仕組みと新しいバージョンのリリース方法の詳細については、 VERSIONING.mdをご覧ください。

バージョンを上げるには:

python scripts/bump_version.py [patch|minor|major]

セキュリティノート

このアプリケーションは、個人的なコミュニケーションが含まれるメッセージデータベースに直接アクセスします。責任を持ってご利用いただき、適切な権限をお持ちであることをご確認ください。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

スターの歴史

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

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

Tools

MCP（Multiple Context Protocol）を使用してmacOSのメッセージアプリとやり取りするためのPythonブリッジ。uvx mac-messages-mcpで簡単にインストールできます。

Related Resources

Reddit Discussion about this server

Related MCP Servers

apple-notifier-mcp
turlockmike
A
security
A
license
A
quality
A simple MCP server that can send notifications on mac devices.
Last updated -
5
9
8
TypeScript
MIT License
MCP Server Python Template
Cris-0k
-
security
A
license
-
quality
A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
Last updated -
13
Python
MIT License
Python Apple MCP
jxnl
-
security
F
license
-
quality
A Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.
Last updated -
5
Python
iMCP
loopwork-ai
-
security
A
license
-
quality
A macOS app that provides an MCP server to your Messages, Contacts, and more
Last updated -
559
Apache 2.0

View all related MCP servers