get_chat_details
Inspect a known thread without opening the full conversation.
How to use it
get_chat_details is exposed by the Imessage Max MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_chat_details tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Imessage Max
/opt/homebrew/Cellar/imessage-max/VERSION/bin/imessage-maxOther tools in Imessage Max (12)
Troubleshoot configuration and permission issues.
Find chats by participants, name, or recent content.
Find chats with recent back-and-forth activity.
Retrieve image content by attachment ID with resolution variants.
Get messages surrounding a specific message.
Retrieve messages with flexible filtering. Returns metadata for media. Explicit chatid lookups are never filtered.
New messages across all chats after a ROWID cursor, in arrival order. Pass the returned nextrowid back as sincerowid to page or poll. nextrowid may be larger than the last returned message's rowid because consumed rows (reactions, filtered chats, orphans) advance it. Omit sincerowid to get only the
Get unread threads or unread messages. Default is summary by chat.
Browse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.
Browse recent chats with previews.
Full-text search across messages.
Send a message or file attachment (requires Automation permission for Messages.app).