mcpbeat Sign in

iMessage History MCP Server

by anipottsbuilds Your server? Claim it
local only

iMessage History runs on your own machine — the client starts it, so there is no endpoint to ping. 155 installs a week from npm. Last commit 24 Oct 2026.

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

Installs per day peak 942 · avg 113 · -60% w/w
a month agotoday
155
Installs / week
npm · imessage-mcp
28
Stars
1 open issue
24 Oct 2026
Last commit
16 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 1 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Package points at a different repository anipottsbuilds/imessage-mcp
пакет imessage-mcp ссылается на anipotts/imessage-mcp

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add imessage-mcp -- npx -y imessage-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.imessage-mcp]
command = "npx"
args = ["-y", "imessage-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "imessage-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

Alternatives to iMessage History

same job, measured the same way
iMessage History
by anipotts

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

local only
Imessage Max
by cyberpapiii

AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.

123 installs/wk local only
Apple Messages
by jonathanrreed

Read Messages history on macOS and send or reply through Messages.app.

814 installs/wk local only
Messages
by cardmagic

Fuzzy search and browse Apple Messages/iMessage from CLI or MCP server

42 installs/wk local only
macOS-only MCP server that exposes iMessage chat
by adelaidasofia

macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…

local only
iCloud Drive Docs
by js713-lab

Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.

local only
Telegram Archive MCP
by geiserx

MCP server for Telegram Archive — search messages, browse chats, and access history

190 installs/wk local only
L
Lumenhaus Energy
by zhuyu1022

Read-only MCP server for Lumenhaus Energy sites, devices, charging sessions, and energy history.

73 installs/wk local only

iMessage History — questions

Answers built from our own checks of this server.

Why is there no uptime for iMessage History?
iMessage History runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package imessage-mcp was installed 155 times last week.
How do I connect iMessage History?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls imessage-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use iMessage History?
The npm package imessage-mcp was installed 155 times in the last week. Week over week that is -60%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is iMessage History open source?
Yes — it is published under the MIT licence, written in TypeScript, 28 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.