Home › Other › iMessage History

iMessage History

Search and read your Apple Messages history from any MCP client. Read-only, local.

TypeScript

★ 25 stars Last pushed 2026-09-24 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 3.2.0)

npx -y imessage-mcp@3.2.0

Or add to your MCP client config:

{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp@3.2.0"
      ],
      "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.