Home › Development › iMessage History

iMessage History

Read-only MCP server for searching and reading Apple Messages history on macOS.

TypeScript
★ 34 stars Last pushed 2026-11-19 License: MIT

Connect

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

Package (npm 3.3.3)

npx -y imessage-mcp@3.3.3

Or add to your MCP client config:

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

This repository has 2 servers listed in the Official MCP Registry.

Other names: io.github.anipotts/imessage-mcp

Related servers

Data from the Official MCP Registry