tool_check_db_access
Diagnose access to ~/Library/Messages/chat.db
How to use it
tool_check_db_access is exposed by the Mac Messages MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the tool_check_db_access tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
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
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
Read recent messages, optionally filtered by contact or group chat ID
Find attachment metadata by date, contact, MIME type, and limit
Send one direct or group message through Messages.app