search_messages

MCP tool from Imessage MCP by anipotts

Full-text search with filters: query, contact, date range, direction, group chat, attachments

How to use it

search_messages is exposed by the Imessage MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search_messages tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Imessage MCP

$npx imessage-mcp doctor

FULL IMESSAGE MCP LISTING

Other tools in Imessage MCP (25)

check_new_messages

Track new messages since your last check (baseline + delta)

Per-contact volumes, trends, and hourly patterns

conversation_gaps

Find the longest silences in a conversation

Detect double-texting and unanswered message patterns

first_last_message

First and last message ever exchanged with a contact

forgotten_contacts

Contacts you've lost touch with

Deep contact info with stats and yearly breakdown

get_conversation

Conversation thread with cursor-based pagination

get_edited_messages

Edited and unsent messages with timing

Per-member stats and monthly activity timeline

get_message_effects

Slam, loud, confetti, fireworks analytics

Tapback distribution, top reactors, most-reacted messages

get_read_receipts

Read/delivery latency and unread patterns

Reconstruct reply thread trees

Full tool guide with usage examples

list_attachments

Query attachments by contact, MIME type, and date range

All contacts with message counts and date ranges

list_group_chats

Group chats with member counts and activity

Aggregate stats with time-series grouping

Messages from this date in past years

resolve_contact

Fuzzy-match a name, phone number, or email to a contact

Consecutive-day messaging streaks

temporal_heatmap

7x24 activity heatmap (day-of-week by hour)

Who starts conversations? Initiation ratio per contact

Spotify Wrapped for iMessage — full year summary