mac_messages_mcp

tool_get_recent_messages

Read recent messages, optionally filtered by contact or group chat ID

tool_fuzzy_search_messages

Search message bodies by approximate text match; defaults to 30 days, or use hours=0 for all history

tool_find_contact

Fuzzy-match a name in Contacts and return phone numbers

tool_get_chats

List named group chats and their identifiers

tool_search_attachments

Find attachment metadata by date, contact, MIME type, and limit

tool_get_attachment

Fetch one attachment by ID, inline when supported or as a local path

tool_check_imessage_availability

Check likely iMessage availability for a phone number or email

tool_check_db_access

Diagnose access to ~/Library/Messages/chat.db

tool_check_contacts

Return a contact count and a small sample

tool_check_addressbook

Diagnose Contacts/AddressBook database access

tool_send_message

Send one direct or group message through Messages.app