Skip to content
MCP server

askmywa for WhatsApp

Local WhatsApp MCP server: search and read chats, send only after you approve

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About askmywa for WhatsApp

askmywa for WhatsApp is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "askmywa": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Ruwad-io/askmywa/releases/download/v0.1.0/askmywa-0.1.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, MIT licence

Prices change. Check askmywa.com before you buy.

askmywa for WhatsApp 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 to askmywa for WhatsApp

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity