Back to Browse

Imessage MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Search and read your Apple Messages history from any MCP client. Read-only, local.

About

Search and read your Apple Messages history from any MCP client. Read-only, local.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 0 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

7 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Most any caller can see: full (default for stdio), redacted, or aggregate.Optional

Environment variable: IMESSAGE_PRIVACY

live (default) names handles from Contacts; none shows handles only.Optional

Environment variable: IMESSAGE_CONTACTS

Path to a copy of chat.db instead of this Mac's Messages database.Optional

Environment variable: IMESSAGE_DB

Set to 0 to keep the search index in memory only.Optional

Environment variable: IMESSAGE_CACHE

Set to 0 to turn off the npm version check.Optional

Environment variable: IMESSAGE_UPDATE_CHECK

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-anipotts-imessage-mcp": {
      "env": {
        "IMESSAGE_DB": "your-imessage-db-here",
        "IMESSAGE_CACHE": "your-imessage-cache-here",
        "IMESSAGE_PRIVACY": "your-imessage-privacy-here",
        "IMESSAGE_CONTACTS": "your-imessage-contacts-here",
        "IMESSAGE_UPDATE_CHECK": "your-imessage-update-check-here"
      },
      "args": [
        "-y",
        "imessage-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!