Mac Messages MCP
by carterlasalle
Mac Messages MCP is a Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol). It allows you to read and send messages programmatically.
Last updated: N/A
What is Mac Messages MCP?
Mac Messages MCP is a Python library and command-line tool that acts as a bridge to the macOS Messages application. It leverages the Multiple Context Protocol (MCP) to enable programmatic interaction with Messages, allowing you to read recent messages, filter by contact, and send new messages.
How to use Mac Messages MCP?
The server can be used as a Python module or a command-line tool. As a module, you can import functions like get_recent_messages and send_message. As a command-line tool, you can run the MCP server directly using mac-messages-mcp. It also provides integration instructions for Claude Desktop and Cursor IDEs.
Key features of Mac Messages MCP
Read recent messages from the macOS Messages app
Filter messages by contact
Send new messages through iMessage
Access messages via an API
Use cases of Mac Messages MCP
Automated messaging
Integration with AI assistants (Claude, Cursor)
Building custom messaging applications
Retrieving message history programmatically
FAQ from Mac Messages MCP
What is MCP?
What is MCP?
MCP stands for Multiple Context Protocol. It allows different applications to communicate and share data.
What are the prerequisites for using Mac Messages MCP?
What are the prerequisites for using Mac Messages MCP?
You need macOS (tested on macOS 11+), Python 3.10+, and the uv package manager.
How do I install Mac Messages MCP?
How do I install Mac Messages MCP?
You can install it from PyPI using uv pip install mac-messages-mcp or from source by cloning the repository and running uv install -e ..
Why does this application need Full Disk Access?
Why does this application need Full Disk Access?
Full Disk Access is required to access the Messages database, which contains personal communications.
Is this application secure?
Is this application secure?
This application accesses the Messages database directly, which contains personal communications. Please use it responsibly and ensure you have appropriate permissions.