find_chat

MCP tool from Imessage Max by cyberpapiii

Find chats by participants, name, or recent content.

How to use it

Project documentation lists find_chat for the Imessage Max 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 Imessage Max

$/opt/homebrew/Cellar/imessage-max/VERSION/bin/imessage-max

FULL IMESSAGE MAX LISTING

Other tools in Imessage Max (12)

diagnose

Troubleshoot configuration and permission issues.

get_active_conversations

Find chats with recent back-and-forth activity.

get_attachment

Retrieve image content by attachment ID with resolution variants.

get_chat_details

Inspect a known thread without opening the full conversation.

get_context

Get messages surrounding a specific message.

get_messages

Retrieve messages with flexible filtering. Returns metadata for media. Explicit chatid lookups are never filtered.

get_messages_since

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

Get unread threads or unread messages. Default is summary by chat.

list_attachments

Browse shared items grouped by message. Each row includes exact attachment ids for follow-up fetches.

list_chats

Browse recent chats with previews.

Full-text search across messages.

send

Send a message or file attachment (requires Automation permission for Messages.app).