imessage-mcp
@anipotts
About imessage-mcp
25 read-only tools for searching, analyzing, and exploring your entire iMessage history on macOS. Spotify Wrapped for texts, conversation analytics, streaks, reactions, read receipts, and more. Everything runs locally.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"imessage": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
ICSS
chokcoco不止于 CSS
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Blender
ahujasidOpen-source MCP to use Blender with any LLM
Comments