MCP Hub › Developer Tools › iMessage History

iMessage History MCP server

by anipotts · io.github.anipotts/imessage-mcp

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

🛠 Developer Toolsnpmv3.3.1
Open in MCP HubGitHub repository ↗

How to install iMessage History

npm

claude mcp add imessage-mcp -- npx -y [email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

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

Environment variables:
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.

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
3.3.1
Published
2026-10-23
Updated
2026-10-23
Namespace
io.github.anipotts
Source
anipotts/imessage-mcp

Similar developer tools servers