iMessage History MCP Server - install & status [2026]

01 · Install iMessage History

Claude Code

claude mcp add anipotts-imessage-mcp -- npx -y imessage-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "anipotts-imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "imessage-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package imessage-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.anipotts is GitHub-verified and matches the repo owner

03 · What iMessage History can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search by substring, exact text, token, or phrase, in message text, conversation names, or attachment names, read a conversation by chat_id or by a contact or group name, with edits, reactions, receipts, replies, and attachments, and find conversations by contact, service, kind, reply state, or date.

Capability map

Tools grouped from the project's README - what iMessage History lets an agent do.

read & search

4 tools - e.g. Search by substring, exact text, token, or phrase, in message text, conversation names, or attachment names; Read a conversation by chat_id or by a contact or group name, with edits, reactions, receipts…

search_messages · get_conversation · list_conversations · get_attachment

Sync

1 tool - e.g. Pull every change since a cursor: new, edited, unsent, and deleted messages, reactions, and receipts

sync_messages

Analyze

1 tool - e.g. Message counts, activity, response times, and who starts conversations

analyze_communication

Resolve

1 tool - e.g. Match a name, phone number, or email to a contact, and report ambiguity rather than guess

resolve_contact

Server

1 tool - e.g. Version, update availability, access, index state, and schema support

server_status

Latest releases

v3.0.1 · 2026-09-15

3.0.1: fix the release npm verification

v2.2.0 · 2026-09-15

first-run install experience and directory readiness (2.2.0)

v2.1.2 · 2026-09-14

refresh changed rows instead of rebuilding per write (2.1.2)

04 · Who maintains iMessage History

iMessage History is maintained by anipotts. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/anipotts/imessage-mcp
category: database - ranked #28 of 168 actively-maintained database servers as of 2026-09-18.
release cadence: 7 releases in the last 90 days (latest 2026-09-15)
registry: io.github.anipotts/imessage-mcp (active, first published 2026-02-25 · 13 versions)
packages: npm:imessage-mcp

06 · iMessage History FAQ

Is iMessage History still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can iMessage History do?

With this server connected, an agent can search by substring, exact text, token, or phrase, in message text, conversation names, or attachment names, read a conversation by chat_id or by a contact or group name, with edits, reactions, receipts, replies, and attachments, and find conversations by contact, service, kind, reply state, or date.

How do I install iMessage History?

Run `npx -y imessage-mcp`. You can also paste the ready-made client config above.

Does iMessage History run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to iMessage History

Alternatives to iMessage History

Maintained database servers if iMessage History isn't the fit.

Pairs well with

Servers that cover what iMessage History doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Garmin Local MCP · Fastbcp MCP · Schema Brain · openLCA MCP Server · Haypile

More TypeScript MCP servers · Sonde · Anki MCP Server · Ng Blatui · Mac Use MCP · Cartograph · see all