# 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

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

Manual MCP config:

```json
{
  "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

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