carterlasalle/mac_messages_mcp
Free安全地与 iMessage 数据库交互的 MCP 服务器，允许 LLM 查询分析对话 (含验证/附件/联系人/群聊/收发)。
FreeFree tier
About carterlasalle/mac_messages_mcp
Mac Messages MCP is an MCP server that securely interfaces with your iMessage database via the Model Context Protocol, allowing LLMs to query and analyze iMessage conversations. It runs locally on your Mac, opens the Messages and Contacts databases read-only, and uses Messages.app automation only when the send tool is explicitly called. Features include reading recent messages, fuzzy-search across text history, finding contacts by approximate name, listing group chats, sending iMessage with SMS/RCS fallback, checking iMessage reachability, finding attachments by date/sender/MIME type, returning small images inline or converting HEIC to PNG, and diagnosing database permissions.
Key Features
Read recent messages across all conversations or filter by contact or group chat
Fuzzy-search message text across a time window including all available history
Find Contacts by approximate name and return send-ready phone numbers
List named group chats and use their chat IDs for reads or sends
Send iMessage with SMS/RCS fallback for eligible phone recipients
Check whether a recipient appears reachable through iMessage before sending
Find attachments by date, sender, and MIME type
Return small images inline, convert HEIC images to PNG, or return a local path for larger and non-image files
Diagnose Messages and Contacts database permissions from inside the MCP client
Opens Messages and Contacts databases read-only for security
Pros & Cons
Pros
- Secure – database access is read-only by default, send only on explicit call
- Supports multiple MCP clients including Claude Desktop, Codex, Cursor, VS Code, and ChatGPT desktop
- Open source and free to use
- Full attachment handling with inline images and HEIC conversion
- Works with SMS/RCS fallback for eligible recipients
Cons
- MacOS only – does not work on other operating systems
- Requires Full Disk Access permission for the launching app
- Requires Messages.app to be open and signed in with a working iMessage account
- Setup involves granting multiple macOS permissions and enabling accessibility for send automation
Best For
Query iMessage conversations from AI assistants like Claude, Codex, or CursorAutomate message sending with MCP clients for reminders or notificationsAnalyze chat history for patterns, sentiment, or data extractionSearch past messages and attachments without manual scrolling
FAQ
Is this tool macOS only?
Yes, Mac Messages MCP is macOS-only because it directly interfaces with the macOS Messages and Contacts databases.
Do I need Full Disk Access?
Yes, reading messages requires Full Disk Access. You must enable it in System Settings > Privacy & Security > Full Disk Access for the app that launches the MCP server.
Can it send messages?
Yes, sending is supported but only when the client explicitly calls the send tool. It uses Messages.app automation and requires the app to be signed in.