25 tools from the iMessage MCP MCP Server, categorised by risk level.
View the iMessage MCP policy →contact_stats Deep per-contact analytics: message volumes, response time estimates, conversation patterns, and yearly trends. conversation_gaps Find the longest silences in a conversation. Detects periods where you and a contact stopped talking — falling-outs, busy periods, or drifting apar... double_texts Detect double-texting and unanswered message patterns. Finds when you (or a contact) sent multiple consecutive messages without a reply. Shows freq... first_last_message The very first and very last message ever exchanged with a contact. People use this for sentimental lookups like 'what was the first text I sent my... forgotten_contacts Find dormant relationships — contacts you used to message but haven't talked to in a long time. Great for reconnecting with people you've lost touc... get_contact Deep info on a specific contact: tier, message stats, yearly breakdown, and recent messages. get_conversation Get a full conversation thread with a specific contact or chat. Supports cursor-based pagination via before_rowid for scrolling through history. get_edited_messages Find edited and unsent (retracted) messages. Queries date_retracted and date_edited columns. Returns message list with timestamps and per-contact s... get_group_chat Detailed info on a specific group chat: all members with per-member message counts, activity timeline, and recent messages. get_message_effects iMessage expressive send effects and screen effects analytics: slam, loud, gentle, invisible ink, confetti, fireworks, balloons, lasers, etc. Queri... get_reactions Tapback/reaction analytics: distribution by type, top reactors, most-reacted messages, emoji breakdown. Queries associated_message_type 2000-2005 f... get_read_receipts Read receipt and delivery timing analytics: per-contact read latency stats, unread patterns, fastest/slowest readers. Queries date_read and date_de... get_thread Reconstruct iMessage reply threads using thread_originator_guid. Returns nested thread trees with parent message and all replies in order. help Show the imessage-mcp guide: all 25 tools and usage examples. Call this when you're unsure what's available. list_attachments Query message attachments (images, videos, audio, documents) with filtering by contact, MIME type, and date range. Returns file metadata, not file ... list_contacts List all contacts with message counts and tier assignments. Supports filtering by tier and minimum message threshold. By default, only shows contac... list_group_chats List all group chats with member counts, message volumes, and activity dates. Group chats have multiple participants. message_stats Aggregate message statistics with flexible time-series grouping. Returns counts, sent/received splits, and averages grouped by day, week, month, ye... on_this_day Messages from this date in previous years — like 'Memories' for iMessage. Shows what you and your contacts were talking about exactly 1, 2, 3+ year... search_messages Full-text search across all iMessages with rich filtering. Supports query text, contact, date range, direction, group chat, and attachment filters.... 3/5 streaks Consecutive-day messaging streaks with contacts. Like Snapchat streaks but for iMessage. Shows longest streak, when it happened, and current streak... temporal_heatmap Generate a 7x24 activity heatmap (day-of-week x hour-of-day). Returns message counts for each of the 168 weekly time slots. By default excludes con... who_initiates Who starts conversations? After a gap of N hours, the next message is a 'conversation initiation.' Shows per-contact who reaches out first and how ... yearly_wrapped Your iMessage Year in Review — like Spotify Wrapped but for texting. Returns a complete summary of a year: total messages, top contacts, busiest da... The iMessage MCP MCP server exposes 25 tools across 2 categories: Read, Write.
Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the iMessage MCP server.
iMessage MCP tools are categorised as Read (24), Write (1). Each category has a recommended default policy.
Open source. One binary. Zero dependencies.
npx -y @policylayer/intercept