Read-only MCP server for searching and reading Apple Messages history on macOS.
Connect Runs on your machine
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 [email protected]{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"IMESSAGE_PRIVACY": "<IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<IMESSAGE_DB>",
"IMESSAGE_CACHE": "<IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<IMESSAGE_UPDATE_CHECK>"
}
}
}
}{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"IMESSAGE_PRIVACY": "<IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<IMESSAGE_DB>",
"IMESSAGE_CACHE": "<IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<IMESSAGE_UPDATE_CHECK>"
}
}
}
}{
"servers": {
"imessage-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"IMESSAGE_PRIVACY": "<IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<IMESSAGE_DB>",
"IMESSAGE_CACHE": "<IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<IMESSAGE_UPDATE_CHECK>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
IMESSAGE_PRIVACYOptional | Most any caller can see: full (default for stdio), redacted, or aggregate. |
IMESSAGE_CONTACTSOptional | live (default) names handles from Contacts; none shows handles only. |
IMESSAGE_DBOptional | Path to a copy of chat.db instead of this Mac's Messages database. |
IMESSAGE_CACHEOptional | Set to 0 to keep the search index in memory only. |
IMESSAGE_UPDATE_CHECKOptional | Set to 0 to turn off the npm version check. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 23 Oct 2026 |
| Last updated | 23 Oct 2026 |
| Registry name | io.github.anipotts/imessage-mcp |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.