find_chat

MCP tool from Imessage Max by cyberpapiii

Find chats by participants, name, or recent content.

How to use it

find_chat is exposed by the Imessage Max MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the find_chat 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-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).