This repository provides a Python bridge, "Mac Messages MCP," for interacting with the macOS Messages app using MCP, enabling users to read, filter, and send messages through an API, requiring
A Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol).
This project provides an API and command-line tool to access and manipulate iMessage data on macOS. Key features include reading recent messages, filtering by contact, and sending new messages.
Requires Full Disk Access permission for the terminal or application. Installation can be done via PyPI or from source using uv.
Supports integration with Claude Desktop and Cursor by configuring the MCP server command.
Can be used as a Python module with functions like get_recent_messages and send_message, or as a command-line tool by running mac-messages-mcp.
Uses semantic versioning. The version can be bumped using python scripts/bump_version.py [patch|minor|major].
Accesses the Messages database directly, requiring responsible use and appropriate permissions.
MIT
Contributions are welcome!
carterlasalle/mac_messages_mcp
March 13, 2025
March 28, 2025
Python