iMessage MCP

latest · 2.0.0-rc.1

Read-only MCP for iMessage, SMS, MMS, and RCS history already present in Apple Messages on Mac.

GitHub: anipotts/imessage-mcp
MCP registry: io.github.anipotts/imessage-mcp

Install

Needs env vars: IMESSAGE_REFERENCE_KEY_FILE, IMESSAGE_DATABASE_ID_FILE — replace the <placeholders> with your values.

claude mcp add io-github-anipotts-imessage-mcp --env IMESSAGE_REFERENCE_KEY_FILE=<IMESSAGE_REFERENCE_KEY_FILE> --env IMESSAGE_DATABASE_ID_FILE=<IMESSAGE_DATABASE_ID_FILE> -- node imessage-mcp

/mcp confirms it's connected.

Install

Or add it manually in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "io-github-anipotts-imessage-mcp": {
      "command": "node",
      "args": [
        "imessage-mcp"
      ],
      "env": {
        "IMESSAGE_REFERENCE_KEY_FILE": "<IMESSAGE_REFERENCE_KEY_FILE>",
        "IMESSAGE_DATABASE_ID_FILE": "<IMESSAGE_DATABASE_ID_FILE>"
      }
    }
  }
}

In claude_desktop_config.json (Settings → Developer → Edit Config), then restart:

{
  "mcpServers": {
    "io-github-anipotts-imessage-mcp": {
      "command": "node",
      "args": [
        "imessage-mcp"
      ],
      "env": {
        "IMESSAGE_REFERENCE_KEY_FILE": "<IMESSAGE_REFERENCE_KEY_FILE>",
        "IMESSAGE_DATABASE_ID_FILE": "<IMESSAGE_DATABASE_ID_FILE>"
      }
    }
  }
}

Config entry, any MCP client:

{
  "command": "node",
  "args": [
    "imessage-mcp"
  ],
  "env": {
    "IMESSAGE_REFERENCE_KEY_FILE": "<IMESSAGE_REFERENCE_KEY_FILE>",
    "IMESSAGE_DATABASE_ID_FILE": "<IMESSAGE_DATABASE_ID_FILE>"
  }
}

Community score

Community48/ 100

from web signals · no reviews yet (community v3)

Web signals (ecosystem baseline)48/100 · 100% of the weight

Used it? Rate v2.0.0-rc.1

No reviews yet — be the first.

What the web says

Ecosystem baseline48/ 100

Objective public usage & activity (formula v3) — the community score's web-signals input, and its own sort.

GitHubsource ↗

GitHub stars · 14 days ago: ★ 27
Last commit · 14 days ago: today
Issue close rate · 14 days ago: 75%
Release cadence · 14 days ago: multiple releases a day
Latest release · 14 days ago: v3.2.0
License · 14 days ago: MIT

Packages

No package-registry data collected yet.

Listed on

Glama · 9 days ago: Listed · Glama quality score 3.9 ↗

Mentions

No public discussion scraped yet.

Docs & liveness

No liveness or verification signals yet.

Version history1

2.0.0-rc.1release date unknown

Badge for your README

Shows this page's community score and its sample, kept current, and links readers here to review.

[![rateme12 community score](https://api.rateme12.com/servers/69971673-d77e-46b8-a1d6-c39f5cda6748/badge.svg)](https://rateme12.com/servers/69971673-d77e-46b8-a1d6-c39f5cda6748)

Details

Transport: stdio
Status: listed
Source: Imported from the MCP registry
Repository: source ↗