iMessage MCP

Indexed by io.github.anipotts

About

25 tools for searching, analyzing, and exploring your iMessage history on macOS.

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)

Env varsIMESSAGE_DB

Claude Code

claude mcp add --env IMESSAGE_DB= imessage-mcp -- npx imessage-mcp

Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code

code --add-mcp '{"name":"imessage-mcp","command":"npx","args":["imessage-mcp"],"env":{"IMESSAGE_DB":""}}'

JSON

{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "imessage-mcp"
      ],
      "env": {
        "IMESSAGE_DB": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.