搜索并阅读你在Claude、Codex、Cursor、VS Code以及任何其他MCP客户端的消息历史记录。

只读。运行在你的Mac上。没有账户，没有云服务，也没有需要编译。

• 通过单词、文本或短语在iMessage、SMS、MMS和RCS中查找消息
• 阅读包含编辑、未发送消息、反应、回复和已读回执的完整对话
• 显示别人发给你的照片，但位置数据已移除
• 通过变更信息流跟踪新消息，并回答计数和回复时间问题

安装

需求： macOS 14 或更新版本。安装 npx Node.js 24.16 或更新版本（Claude Desktop 也有自己的版本）。使用 Node 24 LTS 支持加密缓存。没有 SQLite 检查点 API 的运行时，包括 Node 25，会在内存中搜索并在重启后重建;[doctor 报告此情况。

标准配置，适用于任何读取mcpServers JSON的客户端：

然后给运行它的应用输入全盘访问：系统设置>隐私与安全>全盘访问，打开应用（Claude、你的终端、光标、VS Code等），然后完全退出并重新打开。不确定是哪个应用？从该应用的终端运行npx -y imessage-mcp@latest doctor，它会告诉你。

imessage-mcp

Search and read your Messages history from Claude, Codex, Cursor, VS Code, and any other MCP client.

Read-only. Runs on your Mac. No accounts, no cloud service, nothing to compile.

• Finds messages by words, exact text, or phrase across iMessage, SMS, MMS, and RCS
• Reads whole conversations with edits, unsent messages, reactions, replies, and read receipts
• Shows photos people sent you, with location data removed
• Keeps up with new messages through a change feed, and answers counts and response-time questions

Install

Requirements: macOS 14 or newer. Node.js 24.16 or newer for npx installs (Claude Desktop brings its own). Use Node 24 LTS for encrypted cache support. Runtimes without SQLite checkpoint APIs, including Node 25, search in memory and rebuild after a restart; doctor reports this.

Standard config, for any client that reads mcpServers JSON:

{
  "mcpServers": {
    "imessage": {
      "command": "npx",
      "args": ["-y", "imessage-mcp@latest"]
    }
  }
}

Then give the app that runs it Full Disk Access: System Settings > Privacy & Security > Full Disk Access, turn on the app (Claude, your terminal, Cursor, VS Code, …), then quit it fully and reopen it. Not sure which app? Run npx -y imessage-mcp@latest doctor from that app’s terminal and it tells you. Until access is granted, every tool answers with these same steps.