carterlasalle/mac_messages_mcp
An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
What it solves
This project provides a Model Context Protocol (MCP) server that allows AI assistants (like Claude, Cursor, or VS Code) to interact with the macOS Messages app. It solves the problem of AI agents being unable to access your local messaging history or send iMessages/SMS/RCS messages directly from your Mac.
How it works
The server runs locally on macOS and interacts with the system's Messages and Contacts databases using read-only SQLite connections. To send messages, it uses AppleScript to automate the Messages.app. It requires specific macOS permissions, including Full Disk Access for the launching app and Automation permissions for Messages.app.
Who it’s for
Users of MCP-compatible AI clients (such as Claude Desktop, Cursor, VS Code, or Codex) who want their AI assistants to be able to search, read, and send messages on their Mac.
Highlights
- Comprehensive Messaging Tools: Search message history with fuzzy matching, read recent messages, and list group chats.
- Contact Integration: Find phone numbers and email addresses from the macOS Contacts app.
- Attachment Handling: Search for attachments by date or MIME type and retrieve them, with automatic HEIC to PNG conversion for images.
- Privacy-Focused: Uses read-only database connections and does not upload or mirror message archives.
- Cross-Protocol Support: Sends iMessages with SMS/RCS fallback for eligible recipients.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트