imessage-mcp

Name: imessage-mcp
Author: anipotts

@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.

#imessage #macos #messaging #analytics #privacy #communication #apple #mcp-server

Basic information

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K