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"]
    }
  }
}

Related MCP server: imessage-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