iMessage History MCP Server

What the code does

We read the source, 21 h ago · rules 3dff92dd89df

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

    execFile(

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    execFile(

      const canDrop = windowNormalized.length - first.normalized.length >= matchNeedle.length + SNIPPET_CONTEXT_GRAPHEMES;

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add imessage-mcp -- npx -y imessage-mcp

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

[mcp_servers.imessage-mcp]
command = "npx"
args = ["-y", "imessage-mcp"]

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

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

This one needs environment variables set before it will start: IMESSAGE_PRIVACY (Most any caller can see: full (default for stdio), redacted, or aggregate.), IMESSAGE_CONTACTS (live (default) names handles from Contacts; none shows handles only.), IMESSAGE_DB (Path to a copy of chat.db instead of this Mac's Messages database.), IMESSAGE_CACHE (Set to 0 to keep the search index in memory only.), IMESSAGE_UPDATE_CHECK (Set to 0 to turn off the npm version check.). The author declared them in the registry entry; get the values from the project itself.