// MCP TOOL REFERENCE

IMESSAGE MCP TOOLS

25 tools from the iMessage MCP MCP Server, categorised by risk level.

// ALL 25 IMESSAGE MCP TOOLS

READ 24 tools

Read contact_stats Deep per-contact analytics: message volumes, response time estimates, conversation patterns, and yearly tre... Read conversation_gaps Find the longest silences in a conversation. Detects periods where you and a contact stopped talking — fall... Read double_texts Detect double-texting and unanswered message patterns. Finds when you (or a contact) sent multiple consecut... Read first_last_message The very first and very last message ever exchanged with a contact. People use this for sentimental lookups... Read forgotten_contacts Find dormant relationships — contacts you used to message but haven Read get_contact Deep info on a specific contact: tier, message stats, yearly breakdown, and recent messages. Read get_conversation Get a full conversation thread with a specific contact or chat. Supports cursor-based pagination via before... Read get_edited_messages Find edited and unsent (retracted) messages. Queries date_retracted and date_edited columns. Returns messag... Read get_group_chat Detailed info on a specific group chat: all members with per-member message counts, activity timeline, and ... Read get_message_effects iMessage expressive send effects and screen effects analytics: slam, loud, gentle, invisible ink, confetti,... Read get_reactions Tapback/reaction analytics: distribution by type, top reactors, most-reacted messages, emoji breakdown. Que... Read get_read_receipts Read receipt and delivery timing analytics: per-contact read latency stats, unread patterns, fastest/slowes... Read get_thread Reconstruct iMessage reply threads using thread_originator_guid. Returns nested thread trees with parent me... Read help Show the imessage-mcp guide: all 25 tools and usage examples. Call this when you Read list_attachments Query message attachments (images, videos, audio, documents) with filtering by contact, MIME type, and date... Read list_contacts List all contacts with message counts and tier assignments. Supports filtering by tier and minimum message ... Read list_group_chats List all group chats with member counts, message volumes, and activity dates. Group chats have multiple par... Read message_stats Aggregate message statistics with flexible time-series grouping. Returns counts, sent/received splits, and ... Read on_this_day Messages from this date in previous years — like Read search_messages Full-text search across all iMessages with rich filtering. Supports query text, contact, date range, direct... Read streaks Consecutive-day messaging streaks with contacts. Like Snapchat streaks but for iMessage. Shows longest stre... Read temporal_heatmap Generate a 7x24 activity heatmap (day-of-week x hour-of-day). Returns message counts for each of the 168 we... Read who_initiates Who starts conversations? After a gap of N hours, the next message is a Read yearly_wrapped Your iMessage Year in Review — like Spotify Wrapped but for texting. Returns a complete summary of a year: ...

WRITE 1 tools

Write resolve_contact Fuzzy-match a name, phone number, or email to a contact record. Uses multi-level resolution: exact match, d...

// RUNNING THIS SERVER

The managed route: connect iMessage MCP through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y imessage-mcp

// FAQ

How many tools does the iMessage MCP MCP server have? +

The iMessage MCP MCP server exposes 25 tools across 2 categories: Read, Write.

How do I enforce policies on iMessage MCP tools? +

Route the iMessage MCP server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do iMessage MCP tools fall into? +

iMessage MCP tools are categorised as Read (24), Write (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.