Mac Messages MCP

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.

Prerequisites

• macOS (tested on macOS 11+)
• Python 3.10+
• uv package manager

Installation

Requires Full Disk Access permission for the terminal or application. Installation can be done via PyPI or from source using uv.

Integration

Supports integration with Claude Desktop and Cursor by configuring the MCP server command.

Usage

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.

Development

Uses semantic versioning. The version can be bumped using python scripts/bump_version.py [patch|minor|major].

Security Notes

Accesses the Messages database directly, requiring responsible use and appropriate permissions.

License

MIT

Contributing

Contributions are welcome!