Mac Messages MCP
JSON →A Python bridge for interacting with the macOS Messages app.
Install
npx mcp-proxy Tools · 6
- tool_get_recent_messages Read recent messages from the macOS Messages app, with optional contact filtering and attachment discovery
- tool_fuzzy_search_messages Search through message content with intelligent matching, annotating messages that have attachments
- tool_search_attachments Search attachments by date range, contact, MIME type, and limit, returning metadata only
- tool_get_attachment Fetch a specific attachment by ID, returning inline images or file paths for other types
- tool_find_contact Find a contact by name or phone number, returning phone matches in send-ready format
- tool_get_chats Get chat IDs for group conversations to read one group chat chronologically
Environment variables
MCP_MESSAGES_URL
Links
★ 291 GitHub stars