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

Project documentation lists search_messages for the Imessage MCP 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 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)

contact_stats

Per-contact volumes, trends, and hourly patterns

conversation_gaps

Find the longest silences in a conversation

double_texts

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

get_contact

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

get_group_chat

Per-member stats and monthly activity timeline

get_message_effects

Slam, loud, confetti, fireworks analytics

get_reactions

Tapback distribution, top reactors, most-reacted messages

get_read_receipts

Read/delivery latency and unread patterns

get_thread

Reconstruct reply thread trees

help

Full tool guide with usage examples

list_attachments

Query attachments by contact, MIME type, and date range

list_contacts

All contacts with message counts and date ranges

list_group_chats

Group chats with member counts and activity

message_stats

Aggregate stats with time-series grouping

on_this_day

Messages from this date in past years

resolve_contact

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

streaks

Consecutive-day messaging streaks

temporal_heatmap

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

who_initiates

Who starts conversations? Initiation ratio per contact

yearly_wrapped

Spotify Wrapped for iMessage — full year summary