iMessage History

Package (npm 3.3.2)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "IMESSAGE_PRIVACY": "<YOUR_VALUE>",
        "IMESSAGE_CONTACTS": "<YOUR_VALUE>",
        "IMESSAGE_DB": "<YOUR_VALUE>",
        "IMESSAGE_CACHE": "<YOUR_VALUE>",
        "IMESSAGE_UPDATE_CHECK": "<YOUR_VALUE>"
      }
    }
  }
}

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