Mac Messages MCP
2025.03.17
58
Python消息管理自动化工具交流协作
Mac Messages MCP 是一个基于 Python 的桥梁工具，用于通过 MCP（Multiple Context Protocol）与 macOS 的 Messages 应用进行交互。它提供了读取消息、过滤联系人、发送新消息以及通过 API 访问消息等功能。
View on GitHub
Overview
基本能力
产品定位
Mac Messages MCP 是一个用于与 macOS Messages 应用交互的工具，旨在通过 Python 和 MCP 协议提供消息的读取和发送功能。
核心功能
- 读取 macOS Messages 应用中的最近消息
- 按联系人过滤消息
- 通过 iMessage 发送新消息
- 通过 API 访问消息
适用场景
- 自动化消息处理
- 消息数据的分析和处理
- 与 Messages 应用的集成开发
工具列表
uv包管理器：用于安装和管理 Python 依赖mac-messages-mcp：主工具，提供消息读取和发送功能
常见问题解答
- 权限问题：需要授予终端或应用 Full Disk Access 权限以访问 Messages 数据库。
- 集成问题：在 Claude Desktop 或 Cursor 中集成时，只能运行一个 MCP 服务器实例。
使用教程
使用依赖
- 确保系统为 macOS 11+ 和 Python 3.10+
- 安装
uv包管理器：bash brew install uv
安装教程
- 授予 Full Disk Access 权限：
- 打开 System Preferences/Settings > Security & Privacy/Privacy > Full Disk Access
- 添加终端或应用（如 Terminal, iTerm2）到列表
-
重启终端或应用
-
安装
mac-messages-mcp： - 从 PyPI 安装：
bash uv pip install mac-messages-mcp - 从源码安装：
bash git clone https://github.com/carterlasalle/mac_messages_mcp.git cd mac_messages_mcp uv install -e .
调试方式
- 作为模块使用：
python from mac_messages_mcp import get_recent_messages, send_message messages = get_recent_messages(hours=48) print(messages) result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!") print(result) - 作为命令行工具使用：
bash mac-messages-mcp