mac_messages_mcp
Mac Messages MCP is a Python tool that allows interaction with macOS Messages via Multiple Context Protocol, enabling features like reading, filtering, and sending iMessages through an API. It requires macOS and full disk access permissions due to its direct database interactions.
Mac Messages MCP
A Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol).
Features
- Read recent messages from the macOS Messages app
- Filter messages by contact
- Send new messages through iMessage
- Access messages via an API
Prerequisites
- macOS (tested on macOS 11+)
- Python 3.10+
- uv package manager
Installation
This application requires Full Disk Access permission for your terminal or application to access the Messages database.
Integration
Integrate with Claude Desktop or Cursor by adding specific configurations to access MCP servers.
Usage
- As a module to get recent messages or send messages.
- As a command-line tool to run the MCP server directly.
Security Notes
The application accesses the Messages database directly, which contains personal communications. Use it responsibly and ensure you have appropriate permissions.