Add this MCP server to Claude Code.
Name: iMessage MCP
Merge into: ~/.claude/mcp.json under mcpServers

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

// ── Setup ────────────────────────────────────────────────────────────────────
// macOS only — this server uses AppleScript to interact with Messages.app.
//
// 1. Grant Terminal (or your IDE) Full Disk Access in:
//    System Settings → Privacy & Security → Full Disk Access
//    This is required to read the iMessage database.
//
// 2. Grant Accessibility access if prompted for sending messages.
//
// ── Available tools ──────────────────────────────────────────────────────────
// send_message           send an iMessage to a phone number or email
// read_messages          read recent messages from a conversation
// search_messages        search messages by keyword
// list_conversations     list recent conversations
// get_contact_info       look up a contact's details
//
// ── Tips ─────────────────────────────────────────────────────────────────────
// - Phone numbers should include country code (e.g., +1XXXXXXXXXX)
// - Messages to non-Apple devices will fall back to SMS if enabled
// - The server reads from the local Messages.app database (~Library/Messages/)