imessage-mcp
JSON →25 read-only tools for searching, analyzing, and exploring your entire iMessage history on macOS. Spotify Wrapped for texts, conversation analytics, streaks, read receipts, reactions, and more.
Install
npx -y imessage-mcp Tools · 26
- search_messages Full-text search with filters: query, contact, date range, direction, group chat, attachments
- yearly_wrapped Spotify Wrapped for iMessage — full year summary
- who_initiates Who starts conversations? Initiation ratio per contact
- streaks Consecutive-day messaging streaks
- get_reactions Tapback distribution, top reactors, most-reacted messages
- on_this_day Messages from this date in past years
- get_conversation Conversation thread with cursor-based pagination
- list_contacts All contacts with message counts and date ranges
- get_contact Deep contact info with stats and yearly breakdown
- resolve_contact Fuzzy-match a name, phone number, or email to a contact
- message_stats Aggregate stats with time-series grouping
- contact_stats Per-contact volumes, trends, and hourly patterns
- temporal_heatmap 7x24 activity heatmap (day-of-week by hour)
- first_last_message First and last message ever exchanged with a contact
- double_texts Detect double-texting and unanswered message patterns
- conversation_gaps Find the longest silences in a conversation
- forgotten_contacts Contacts you've lost touch with
- list_group_chats Group chats with member counts and activity
- get_group_chat Per-member stats and monthly activity timeline
- list_attachments Query attachments by contact, MIME type, and date range
- get_read_receipts Read/delivery latency and unread patterns
- get_thread Reconstruct reply thread trees
- get_edited_messages Edited and unsent messages with timing
- get_message_effects Slam, loud, confetti, fireworks analytics
- check_new_messages Track new messages since your last check (baseline + delta)
- help Full tool guide with usage examples
Environment variables
IMESSAGE_API_TOKEN
Links
★ 10 GitHub stars