imessage-mcp

What is imessage-mcp?

imessage-mcp is a set of 25 read-only MCP tools for searching, analyzing, and exploring your entire iMessage history on macOS. It is designed for users who want to gain insights from their own messages without sending data anywhere.

How to use imessage-mcp?

Run npx -y imessage-mcp on macOS with Node.js 18+ and Full Disk Access enabled. No configuration file is needed; the tools are automatically available once the server is started.

Key features of imessage-mcp

• Full-text message search with filters
• Per-contact analytics and conversation patterns
• Spotify Wrapped-style yearly summary
• Streak tracking and double-text detection
• Tapback/reaction analysis
• Read receipt timing analysis
• Group chat breakdowns
• Edited/unsent message detection
• Safe mode that redacts message bodies

Use cases of imessage-mcp

• Generate a yearly summary of your messaging habits
• Analyze response times and double-texting patterns with a contact
• Detect when messages were edited or unsent
• Track conversation streaks and tapback reactions
• Explore group chat activity and participation

FAQ from imessage-mcp

Does this tool send my message data anywhere?

No. imessage-mcp is fully offline — it makes no network requests and no data leaves your Mac.

What are the system requirements?

macOS with Full Disk Access enabled, and Node.js version 18 or higher.

How do I install imessage-mcp?

Run npx -y imessage-mcp in your terminal. No global installation is required.

What does "read-only" mean?

All 25 tools only query your iMessage database; they never modify, delete, or send any messages.

Is there a way to hide message content in logs or output?

Yes. Safe mode redacts message bodies, showing only metadata like timestamps and contact names.