iMessage History
Rank #941io.github.anipotts/imessage-mcp
Search and read your Apple Messages history from any MCP client. Read-only, local.
iMessage History is a Model Context Protocol (MCP) server published by anipotts. It ranks #941 of 132,046 servers tracked on MCP Toplist, and its repository has 25 GitHub stars. iMessage History is listed across 4 registries — Official MCP, PulseMCP, Glama and mcp.so, with 15 tracked versions. It was first listed on Feb 25, 2026 and most recently updated on Sep 21, 2026.
Ranks ahead of 131,105 of 132,046 servers on MCP Toplist.
Use iMessage History
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add imessage-mcp -e "IMESSAGE_PRIVACY=<your IMESSAGE_PRIVACY>" -e "IMESSAGE_CONTACTS=<your IMESSAGE_CONTACTS>" -e "IMESSAGE_DB=<your IMESSAGE_DB>" -e "IMESSAGE_CACHE=<your IMESSAGE_CACHE>" -e "IMESSAGE_UPDATE_CHECK=<your IMESSAGE_UPDATE_CHECK>" -- npx -y imessage-mcpReplace each placeholder with your own value before saving.
[mcp_servers.imessage-mcp]
command = "npx"
args = ["-y", "imessage-mcp"]
[mcp_servers.imessage-mcp.env]
IMESSAGE_PRIVACY = "<your IMESSAGE_PRIVACY>"
IMESSAGE_CONTACTS = "<your IMESSAGE_CONTACTS>"
IMESSAGE_DB = "<your IMESSAGE_DB>"
IMESSAGE_CACHE = "<your IMESSAGE_CACHE>"
IMESSAGE_UPDATE_CHECK = "<your IMESSAGE_UPDATE_CHECK>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<your IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<your IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<your IMESSAGE_DB>",
"IMESSAGE_CACHE": "<your IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<your IMESSAGE_UPDATE_CHECK>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<your IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<your IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<your IMESSAGE_DB>",
"IMESSAGE_CACHE": "<your IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<your IMESSAGE_UPDATE_CHECK>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"imessage-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<your IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<your IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<your IMESSAGE_DB>",
"IMESSAGE_CACHE": "<your IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<your IMESSAGE_UPDATE_CHECK>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<your IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<your IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<your IMESSAGE_DB>",
"IMESSAGE_CACHE": "<your IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<your IMESSAGE_UPDATE_CHECK>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<your IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<your IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<your IMESSAGE_DB>",
"IMESSAGE_CACHE": "<your IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<your IMESSAGE_UPDATE_CHECK>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.anipotts%2Fimessage-mcp)<a href="https://mcptoplist.com/server/io.github.anipotts%2Fimessage-mcp"><img src="https://mcptoplist.com/badge/io.github.anipotts%2Fimessage-mcp.svg" alt="MCP Toplist: Top 1% of 132,046" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 4 registries
anipotts
Available versions (15)
| Version | Published |
|---|---|
| 3.0.2 | Sep 21, 2026 |
| 3.0.1 | Sep 15, 2026 |
| 2.2.0 | Sep 15, 2026 |
| 2.1.2 | Sep 14, 2026 |
| 2.1.1 | Sep 14, 2026 |
| 2.1.0 | Sep 14, 2026 |
| 2.0.1 | Sep 14, 2026 |
| 2.0.0 | Sep 14, 2026 |
| 2.0.0-rc.2 | Sep 12, 2026 |
| 2.0.0-rc.1 | Aug 27, 2026 |
| 2.0.0-beta.3 | Aug 27, 2026 |
| 2.0.0-beta.2 | Aug 27, 2026 |
| 1.3.1 | Aug 26, 2026 |
| 1.2.1 | Feb 25, 2026 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains iMessage History?
- iMessage History is maintained by anipotts, which publishes 1 MCP server (15 total versions) tracked on MCP Toplist.
- Is iMessage History listed on the Official MCP Registry?
- Yes — iMessage History is listed on the Official MCP Registry, alongside PulseMCP, Glama and mcp.so.
- How many versions does iMessage History have?
- MCP Toplist tracks 15 versions of iMessage History, most recently published on Sep 21, 2026.
- Where can I find the source code for iMessage History?
- The source code for iMessage History is hosted at github.com/anipotts/imessage-mcp.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.