MCP Server

Active

MIT

WhatsApp MCP MCP Server

Name: WhatsApp MCP MCP Server
Author: io.github.adelaidasofia

io.github.adelaidasofia/whatsapp-mcp

Repository Registry

What is the WhatsApp MCP MCP server?

WhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription.

How to install WhatsApp MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

WHATSAPP_BRIDGE_HOST
Hostname for the Go bridge REST API.
WHATSAPP_BRIDGE_PORT
Port for the Go bridge REST API.
WHATSAPP_VAULT_CRM_PATH
Absolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
WHATSAPP_WHISPER_BACKEND
Voice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
WHATSAPP_WHISPER_API_KEY
secret
OpenAI API key. Required only when WHATSAPP_WHISPER_BACKEND=openai-api.
WHATSAPP_WHISPER_MODEL
whisper.cpp model name. Only used when backend is local-cpp.
WHATSAPP_SCRUB_PROMPT_INJECTION
Strip known prompt-injection patterns from incoming messages before the LLM sees them.
WHATSAPP_AUDIT_LOG
Log every tool call to audit.log.
WHATSAPP_ENCRYPT_DB
Enable SQLCipher DB encryption with the key sourced from macOS Keychain.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_BRIDGE_HOST": "<YOUR_WHATSAPP_BRIDGE_HOST>",
        "WHATSAPP_BRIDGE_PORT": "<YOUR_WHATSAPP_BRIDGE_PORT>",
        "WHATSAPP_VAULT_CRM_PATH": "<YOUR_WHATSAPP_VAULT_CRM_PATH>",
        "WHATSAPP_WHISPER_BACKEND": "<YOUR_WHATSAPP_WHISPER_BACKEND>",
        "WHATSAPP_WHISPER_API_KEY": "<YOUR_WHATSAPP_WHISPER_API_KEY>",
        "WHATSAPP_WHISPER_MODEL": "<YOUR_WHATSAPP_WHISPER_MODEL>",
        "WHATSAPP_SCRUB_PROMPT_INJECTION": "<YOUR_WHATSAPP_SCRUB_PROMPT_INJECTION>",
        "WHATSAPP_AUDIT_LOG": "<YOUR_WHATSAPP_AUDIT_LOG>",
        "WHATSAPP_ENCRYPT_DB": "<YOUR_WHATSAPP_ENCRYPT_DB>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_BRIDGE_HOST": "<YOUR_WHATSAPP_BRIDGE_HOST>",
        "WHATSAPP_BRIDGE_PORT": "<YOUR_WHATSAPP_BRIDGE_PORT>",
        "WHATSAPP_VAULT_CRM_PATH": "<YOUR_WHATSAPP_VAULT_CRM_PATH>",
        "WHATSAPP_WHISPER_BACKEND": "<YOUR_WHATSAPP_WHISPER_BACKEND>",
        "WHATSAPP_WHISPER_API_KEY": "<YOUR_WHATSAPP_WHISPER_API_KEY>",
        "WHATSAPP_WHISPER_MODEL": "<YOUR_WHATSAPP_WHISPER_MODEL>",
        "WHATSAPP_SCRUB_PROMPT_INJECTION": "<YOUR_WHATSAPP_SCRUB_PROMPT_INJECTION>",
        "WHATSAPP_AUDIT_LOG": "<YOUR_WHATSAPP_AUDIT_LOG>",
        "WHATSAPP_ENCRYPT_DB": "<YOUR_WHATSAPP_ENCRYPT_DB>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_BRIDGE_HOST": "<YOUR_WHATSAPP_BRIDGE_HOST>",
        "WHATSAPP_BRIDGE_PORT": "<YOUR_WHATSAPP_BRIDGE_PORT>",
        "WHATSAPP_VAULT_CRM_PATH": "<YOUR_WHATSAPP_VAULT_CRM_PATH>",
        "WHATSAPP_WHISPER_BACKEND": "<YOUR_WHATSAPP_WHISPER_BACKEND>",
        "WHATSAPP_WHISPER_API_KEY": "<YOUR_WHATSAPP_WHISPER_API_KEY>",
        "WHATSAPP_WHISPER_MODEL": "<YOUR_WHATSAPP_WHISPER_MODEL>",
        "WHATSAPP_SCRUB_PROMPT_INJECTION": "<YOUR_WHATSAPP_SCRUB_PROMPT_INJECTION>",
        "WHATSAPP_AUDIT_LOG": "<YOUR_WHATSAPP_AUDIT_LOG>",
        "WHATSAPP_ENCRYPT_DB": "<YOUR_WHATSAPP_ENCRYPT_DB>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "whatsapp-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_BRIDGE_HOST": "<YOUR_WHATSAPP_BRIDGE_HOST>",
        "WHATSAPP_BRIDGE_PORT": "<YOUR_WHATSAPP_BRIDGE_PORT>",
        "WHATSAPP_VAULT_CRM_PATH": "<YOUR_WHATSAPP_VAULT_CRM_PATH>",
        "WHATSAPP_WHISPER_BACKEND": "<YOUR_WHATSAPP_WHISPER_BACKEND>",
        "WHATSAPP_WHISPER_API_KEY": "<YOUR_WHATSAPP_WHISPER_API_KEY>",
        "WHATSAPP_WHISPER_MODEL": "<YOUR_WHATSAPP_WHISPER_MODEL>",
        "WHATSAPP_SCRUB_PROMPT_INJECTION": "<YOUR_WHATSAPP_SCRUB_PROMPT_INJECTION>",
        "WHATSAPP_AUDIT_LOG": "<YOUR_WHATSAPP_AUDIT_LOG>",
        "WHATSAPP_ENCRYPT_DB": "<YOUR_WHATSAPP_ENCRYPT_DB>"
      }
    }
  }
}

Claude Code

claude mcp add whatsapp-mcp --env WHATSAPP_BRIDGE_HOST=<YOUR_WHATSAPP_BRIDGE_HOST> --env WHATSAPP_BRIDGE_PORT=<YOUR_WHATSAPP_BRIDGE_PORT> --env WHATSAPP_VAULT_CRM_PATH=<YOUR_WHATSAPP_VAULT_CRM_PATH> --env WHATSAPP_WHISPER_BACKEND=<YOUR_WHATSAPP_WHISPER_BACKEND> --env WHATSAPP_WHISPER_API_KEY=<YOUR_WHATSAPP_WHISPER_API_KEY> --env WHATSAPP_WHISPER_MODEL=<YOUR_WHATSAPP_WHISPER_MODEL> --env WHATSAPP_SCRUB_PROMPT_INJECTION=<YOUR_WHATSAPP_SCRUB_PROMPT_INJECTION> --env WHATSAPP_AUDIT_LOG=<YOUR_WHATSAPP_AUDIT_LOG> --env WHATSAPP_ENCRYPT_DB=<YOUR_WHATSAPP_ENCRYPT_DB> -- uvx adelaidasofia-whatsapp-mcp

Related MCP servers

FastMCP server for Apollo

Active

FastMCP server for Apollo.io — 22 tools: sequences, campaign health, mailbox warmup, enrichment,…

Python

MIT

View repository →

FastMCP server for surgical queries against a vault knowledge graph (NetworkX no

Active

FastMCP server for surgical queries against a vault knowledge graph (NetworkX node-link JSON).…

Python

MIT

View repository →

Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token

Active

Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…

Python

MIT

View repository →

macOS-only MCP server that exposes iMessage chat

Active

macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…

Python

MIT

View repository →

Multi-workspace Slack MCP server with draft+confirm safety, vault auto-export, a

Active

Multi-workspace Slack MCP server with draft+confirm safety, vault auto-export, and triple-mode…

Python

MIT

View repository →

FastMCP server for Substack — publish Notes and posts, pull analytics, manage dr

Active

FastMCP server for Substack — publish Notes and posts, pull analytics, manage drafts, pluggable…

Python

MIT

View repository →