Skip to content
MCP server

Whatsapp Tools

Read, search and send WhatsApp messages from coding agents on your own account

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
whatsapp, CLI, self-hosted
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About Whatsapp Tools

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

whatsapp-tools gives coding agents a way to work with a person's own WhatsApp chats, messages, contacts, history, received files and sends. It reads from a local mirror kept by a wacli sync service, so reads need no network, and its account tool reports pairing state, the sync service, last activity and wacli support without exposing message content, numbers or keys.

The README names two tools: whatsapp_account_read and whatsapp_chat_read, the latter with list, view, search and around methods. What it returns of other people's words is treated as data, never as instructions. Tools are grouped into toolsets with matching skills.

Delivery varies by harness: native plugins for OpenCode V1 and V2, plugins for Claude Code, Codex, Grok Build and Antigravity, a Python plugin for Hermes Agent 0.22 or later, and an npm MCP server for other hosts. Node.js 24 or later is needed. On Hermes, the gateway's environment decides where wacli and node are found. Install from a release tag, not the default branch.

Install

Run in a terminal

claude mcp add whatsapp-tools -- npx -y @craftsamo/whatsapp-tools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "whatsapp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/whatsapp-tools"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/whatsapp-tools"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "whatsapp-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/whatsapp-tools"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "whatsapp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/whatsapp-tools"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "whatsapp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/whatsapp-tools"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

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

whatsapp_account_read
Pairing, sync service state, last activity and wacli support
whatsapp_chat_read
List chats, view messages, search words or read around a message

What it does

Chat reading
List chats, view messages, search by words and read around a message.
Contacts and history
Covers contacts and message history from the local mirror.
Account status
Shows pairing, sync service state and wacli support without private data.
Received files and sends
Handles received files and sends, with a read-only option.
Approval-aware
Codex plugin asks before any tool not marked read-only.
Many harnesses
Plugins for OpenCode, Claude Code, Codex, Grok Build, Antigravity and Hermes.

Good for

  • Look up what someone said in an old chat
  • Summarise a group conversation for a coding agent
  • Check whether WhatsApp sync is paired and recent
  • Send a message with explicit approval

Pricing

Open source

Free npm package; licence in the repo

More servers for the same service

Whatsapp Tools FAQ

Does reading need the network?

No. Chat reads use the account's local mirror only.

What does it depend on?

A `wacli` sync service and Node.js 24 or later.

Can I block sending?

Yes, through the `read_only` option or `--read-only` flag.

Does the account tool reveal my number?

No. It returns no message content, number, JID or key.

Is Whatsapp Tools free?

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

How do I add Whatsapp Tools to Claude Code?

Run this command in your terminal: claude mcp add whatsapp-tools -- npx -y @craftsamo/whatsapp-tools

What are the best alternatives to Whatsapp Tools?

The closest alternatives to Whatsapp Tools are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers