# askmywa for WhatsApp

> askmywa for WhatsApp is an open-source MCP server for communication. Local WhatsApp MCP server: search and read chats, send only after you approve. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Website:** https://askmywa.com
- **Repository:** https://github.com/ruwad-io/askmywa
- **MCP Registry name:** io.github.Ruwad-io/askmywa
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

This one keeps a SQLite archive of your WhatsApp messages on your own computer, linked the way WhatsApp Web is, through the whatsmeow library. Nothing reaches the assistant unless it calls a tool, and the site says there is no askmywa server, no account and no tracking. Senders are resolved to real names from your address book first, and phone numbers and hidden @lid identifiers are merged into one contact.

Search is full-text and ignores accents and case, so `ecole` finds `école`. Sending is gated: `send_message`, `send_file` and `send_audio_message` return only a preview until they are called again with `confirm=true`. Files can only be sent from one configured folder, and the server talks to the WhatsApp daemon over a private Unix socket rather than a network port.

The README is a rewrite of lharries/whatsapp-mcp as a single Go binary and keeps the same tool names, so existing prompts keep working. It warns that it is not made by WhatsApp, that WhatsApp's terms do not allow this kind of linking and could lead to an account ban, and that prompt injection in incoming messages is a risk.

## Features

- **Local message archive:** Messages are stored in SQLite on your computer.
- **Accent-insensitive search:** Full-text search that ignores case and accents.
- **Approval before sending:** Messages and files show a preview and send only on confirm=true.
- **Contact name resolution:** Address-book names are used, with numbers and @lid IDs merged.
- **Single Go binary:** Runs on Mac, Windows and Linux, including Raspberry Pi.
- **One-click Claude install:** A .mcpb file installs it in Claude Desktop without a terminal.

## Good for

- Summarise a family or building group chat
- Find a quote or file someone sent weeks ago
- Download an attachment from a chat
- Draft and send a reply after reviewing the preview

## Install

### Claude Code (Terminal)

```sh
claude mcp add askmywa -- npx -y https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "askmywa": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `send_message`: Previews a message, and sends it when called again with confirm=true.
- `send_file`: Previews a file send, and sends it on confirm=true.
- `send_audio_message`: Previews an audio message, and sends it on confirm=true.

## FAQ

### Is it free?

The site calls it free and open source under the MIT licence.

### Does it work on claude.ai or the phone app?

No. It needs the Claude desktop app, and the ChatGPT app on a Mac or Codex via an install script.

### Can it send messages on its own?

No. Every send returns a preview first and goes out only after you approve it.

### Could my account be banned?

The site warns that WhatsApp's terms do not allow this and it could restrict or ban an account that uses it.

### How do I link my number?

Ask Claude to connect your WhatsApp, then type the one-time code in WhatsApp under Linked devices.

### Is askmywa for WhatsApp free?

Yes. askmywa for WhatsApp is open source, so you can use and self-host it for free.

### How do I add askmywa for WhatsApp to Claude Code?

Run this command in your terminal: claude mcp add askmywa -- npx -y https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb

### What are the best alternatives to askmywa for WhatsApp?

The closest alternatives to askmywa for WhatsApp are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/askmywa-for-whatsapp
