29 v3.3.2 更新于 2026-10-23

iMessage History MCP Server

只读 MCP 服务器,用于在 macOS 上搜索和读取 Apple Messages 历史。

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(npm)

{
  "mcpServers": {
    "imessage-mcp-689dd8": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

search_messages

按子串、精确文本、词元或短语搜索消息，可按服务和日期过滤

get_conversation

按 chat_id 或联系人/群组名称读取完整对话，包括编辑、回应、回执和附件

list_conversations

按联系人、服务、类型、回复状态或日期查找对话，并显示最新消息

get_attachment

展示对话中的附件，图片会去除位置和相机元数据

sync_messages

通过游标拉取所有变更，包括新消息、编辑、撤回、成员变动和回执

analyze_communication

分析消息按小时和星期的分布、响应时间、连续记录及发起者统计

resolve_contact

将姓名、电话或邮箱匹配到 Mac 通讯录中的联系人，遇歧义时报告而非猜测