tool_get_recent_messages
Read recent messages, optionally filtered by contact or group chat ID
How to use it
Project documentation lists tool_get_recent_messages for the Mac Messages MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Mac Messages MCP
uvx --versionOther tools in Mac Messages MCP (10)
Diagnose Contacts/AddressBook database access
Return a contact count and a small sample
Diagnose access to ~/Library/Messages/chat.db
Check likely iMessage availability for a phone number or email
Fuzzy-match a name in Contacts and return phone numbers
Search message bodies by approximate text match; defaults to 30 days, or use hours=0 for all history
Fetch one attachment by ID, inline when supported or as a local path
List named group chats and their identifiers
Find attachment metadata by date, contact, MIME type, and limit
Send one direct or group message through Messages.app