iMessage History for Claude Code

io.github.anipotts/imessage-mcp

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

client:Claude Code transport:stdio runtime:npm

Install iMessage History in Claude Code

run in your project directory

claude mcp add imessage-mcp -e IMESSAGE_PRIVACY=<IMESSAGE_PRIVACY> -e IMESSAGE_CONTACTS=<IMESSAGE_CONTACTS> -e IMESSAGE_DB=<IMESSAGE_DB> -e IMESSAGE_CACHE=<IMESSAGE_CACHE> -e IMESSAGE_UPDATE_CHECK=<IMESSAGE_UPDATE_CHECK> -- npx -y imessage-mcp

Adds it for this project only. Append --scope user to make it available everywhere. Claude Code docs

iMessage History in other clients

Claude Desktop
Cursor
VS Code
Zed
Windsurf
Cline
Gemini CLI
Grok
LangChain

iMessage History MCP server