iMessage History

local MCP server

Installation

Terminal

claude mcp add io-github-anipotts-imessage-mcp -e IMESSAGE_PRIVACY=... -e IMESSAGE_CONTACTS=... -e IMESSAGE_DB=... -e IMESSAGE_CACHE=... -e IMESSAGE_UPDATE_CHECK=... -- npx -y imessage-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-anipotts-imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ],
      "env": {
        "IMESSAGE_PRIVACY": "...",
        "IMESSAGE_CONTACTS": "...",
        "IMESSAGE_DB": "...",
        "IMESSAGE_CACHE": "...",
        "IMESSAGE_UPDATE_CHECK": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

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

Questions

iMessage History is a local MCP server distributed as the npm package imessage-mcp.

Run: claude mcp add io-github-anipotts-imessage-mcp -e IMESSAGE_PRIVACY=... -e IMESSAGE_CONTACTS=... -e IMESSAGE_DB=... -e IMESSAGE_CACHE=... -e IMESSAGE_UPDATE_CHECK=... -- npx -y imessage-mcp

Run: codex mcp add io-github-anipotts-imessage-mcp --env IMESSAGE_PRIVACY=... --env IMESSAGE_CONTACTS=... --env IMESSAGE_DB=... --env IMESSAGE_CACHE=... --env IMESSAGE_UPDATE_CHECK=... -- npx -y imessage-mcp

Similar MCP servers

NameStars

braveai.smithery/brave1,477
SoloMDio.github.zhitongblog/solomd1,130
code-memoryio.github.kapillamba4/code-memory49
alive-analysisio.github.with-geun/alive-analysis41
iFlow Searchio.github.zhengyanglsun/iflow-search32
apple-mail-mcpio.github.parasxos/apple-mail-mcp29
messagesio.github.cardmagic/messages20
Apple Messagesio.github.JonathanRReed/apple-messages-mcp18