imessage-mcp

Sunrise-Labs-Dot-AI/imessage-mcp

★ 0 stars TypeScript 🤖 AI/LLM Updated 6d ago

Local MCP server for macOS iMessages: read with required filters, draft-stage with auto-attached thread context, send via Messages.app. Companion SwiftUI menu bar review app. For Claude Desktop / Claude Code / Codex CLI.

View on GitHub →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "imessage-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "Sunrise-Labs-Dot-AI/imessage-mcp"
      ]
    }
  }
}

README Excerpt

A local MCP server that exposes read-only access to your macOS iMessages (`~/Library/Messages/chat.db`) and lets agents stage outgoing drafts as local JSON files. **Drafts never auto-send.** - P0 — read iMessage threads, messages, and search. - P1 — stage drafts under `~/.imessage-mcp/drafts/`. - P2 — approval-gated send of staged drafts via AppleScript automation.

Tools (9)

discard_imessage_draftget_imessage_current_timeget_imessage_draftget_imessage_threadlist_imessage_draftslist_imessage_threadssearch_imessagessend_imessage_draftstage_imessage_draft

Topics

anthropicchat-dbclaudecodeximessagemacosmcpmodel-context-protocol

imessage-mcp

Quick Install

README Excerpt

Tools (9)

Topics

Related AI/LLM Servers