# Whatsapp Tools

> Whatsapp Tools is an open-source MCP server for communication. Read, search and send WhatsApp messages from coding agents on your own account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** whatsapp, CLI, self-hosted
- **Repository:** https://github.com/craft-agent/whatsapp-tools
- **MCP Registry name:** io.github.craft-agent/whatsapp-tools
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/whatsapp-tools
