DUGGAI Messages MCP

Local-first WhatsApp and iMessage memory for AI coding agents.

The server reads local SQLite stores for WhatsApp and iMessage where available, then exposes scoped MCP tools for search, recent context, relationship summaries, reply drafting, compose-open, and unreplied threads.

Install

npx --yes github:duggsha/whatsapp-mcp install --client codex

Manual MCP config:

{
  "mcpServers": {
    "duggai-messages": {
      "command": "npx",
      "args": ["--yes", "github:duggsha/whatsapp-mcp"]
    }
  }
}

Tools

find_store
find_imessage_store
list_chats
search_messages
recent_messages
list_imessage_chats
search_imessages
recent_imessages
relationship_context
draft_reply
open_reply_draft
unreplied_threads

Privacy

Read-only by default.
Messages stay on the user's Mac.
iMessage may require Full Disk Access for the terminal/editor running the MCP.
Phone/JID values are redacted unless rawJids: true.
Result limits are clamped.
Broad history dumps are intentionally not a first-class tool.
Replying is draft-first. open_reply_draft opens WhatsApp with prefilled text for supported one-to-one chats, but does not press Send.

Local diagnostics

npx --yes github:duggsha/whatsapp-mcp diagnose