{"slug":"anipotts/imessage-mcp","name":"imessage-mcp","description":"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.","category":"communication","tags":[],"official":false,"stars":10,"transport":"stdio","install":[{"cmd":"npx -y imessage-mcp","imports":[]}],"tools":[{"name":"search_messages","description":"Full-text search with filters: query, contact, date range, direction, group chat, attachments"},{"name":"yearly_wrapped","description":"Spotify Wrapped for iMessage — full year summary"},{"name":"who_initiates","description":"Who starts conversations? Initiation ratio per contact"},{"name":"streaks","description":"Consecutive-day messaging streaks"},{"name":"get_reactions","description":"Tapback distribution, top reactors, most-reacted messages"},{"name":"on_this_day","description":"Messages from this date in past years"},{"name":"get_conversation","description":"Conversation thread with cursor-based pagination"},{"name":"list_contacts","description":"All contacts with message counts and date ranges"},{"name":"get_contact","description":"Deep contact info with stats and yearly breakdown"},{"name":"resolve_contact","description":"Fuzzy-match a name, phone number, or email to a contact"},{"name":"message_stats","description":"Aggregate stats with time-series grouping"},{"name":"contact_stats","description":"Per-contact volumes, trends, and hourly patterns"},{"name":"temporal_heatmap","description":"7x24 activity heatmap (day-of-week by hour)"},{"name":"first_last_message","description":"First and last message ever exchanged with a contact"},{"name":"double_texts","description":"Detect double-texting and unanswered message patterns"},{"name":"conversation_gaps","description":"Find the longest silences in a conversation"},{"name":"forgotten_contacts","description":"Contacts you've lost touch with"},{"name":"list_group_chats","description":"Group chats with member counts and activity"},{"name":"get_group_chat","description":"Per-member stats and monthly activity timeline"},{"name":"list_attachments","description":"Query attachments by contact, MIME type, and date range"},{"name":"get_read_receipts","description":"Read/delivery latency and unread patterns"},{"name":"get_thread","description":"Reconstruct reply thread trees"},{"name":"get_edited_messages","description":"Edited and unsent messages with timing"},{"name":"get_message_effects","description":"Slam, loud, confetti, fireworks analytics"},{"name":"check_new_messages","description":"Track new messages since your last check (baseline + delta)"},{"name":"help","description":"Full tool guide with usage examples"}],"env_vars":["IMESSAGE_API_TOKEN"],"auth_type":"none","github":"https://github.com/anipotts/imessage-mcp","homepage":"","server_url":"","status":"active","source":"mcpservers.org","updated_at":"Thu May 28"}