MCP Servers / communication / imessage-mcp

imessage-mcp

JSON →
stdionone10communication

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
How to run this server
[ { "cmd": "npx -y imessage-mcp", "imports": [] } ]
server path: imessage-mcp
Tools
What this server exposes
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
Configuration
Environment & auth
authnone
envIMESSAGE_API_TOKEN
Resources
imessage-mcp — MCP Server · libregistry