A
securityA
licenseA
qualityEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Last updated -
7
150
2,508
MIT License
Mac メッセージ MCP
MCP (Multiple Context Protocol) を使用して macOS メッセージ アプリと対話するための Python ブリッジ。
特徴
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]
セキュリティノート
このアプリケーションは、個人的なコミュニケーションが含まれるメッセージデータベースに直接アクセスします。責任を持ってご利用いただき、適切な権限をお持ちであることをご確認ください。
ライセンス
マサチューセッツ工科大学
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
スターの歴史
Related MCP Servers
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated -884MIT License
- -securityAlicense-qualityA collection of Apple-native tools for the MCP protocol that enables AI assistants to interact with Apple applications including Messages, Notes, Contacts, Mail, Reminders, Calendar, and Maps.
- -securityFlicense-qualityA Python-based MCP server that uses uv for dependency management, requiring Python 3.13+ to run.