iMessage History

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.anipotts/imessage-mcp",
  "description": "Search and read your Apple Messages history from any MCP client. Read-only, local.",
  "title": "iMessage History",
  "repository": {
    "url": "https://github.com/anipotts/imessage-mcp",
    "source": "github"
  },
  "version": "3.2.0",
  "icons": [
    {
      "src": "https://raw.githubusercontent.com/anipotts/imessage-mcp/v3.2.0/assets/icon.svg",
      "mimeType": "image/svg+xml",
      "sizes": [
        "any"
      ]
    },
    {
      "src": "https://raw.githubusercontent.com/anipotts/imessage-mcp/v3.2.0/assets/icon-512.png",
      "mimeType": "image/png",
      "sizes": [
        "512x512"
      ]
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "identifier": "imessage-mcp",
      "version": "3.2.0",
      "runtimeHint": "node",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Most any caller can see: full (default for stdio), redacted, or aggregate.",
          "name": "IMESSAGE_PRIVACY"
        },
        {
          "description": "live (default) names handles from Contacts; none shows handles only.",
          "name": "IMESSAGE_CONTACTS"
        },
        {
          "description": "Path to a copy of chat.db instead of this Mac's Messages database.",
          "name": "IMESSAGE_DB"
        },
        {
          "description": "Set to 0 to keep the search index in memory only.",
          "name": "IMESSAGE_CACHE"
        },
        {
          "description": "Set to 0 to turn off the npm version check.",
          "name": "IMESSAGE_UPDATE_CHECK"
        }
      ]
    }
  ]
}