# 安装 WhatsApp Web MCP Server

- 类型: MCP 工具
- 说明: MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts
- 仓库: https://github.com/mario-andreschak/mcp-whatsapp-web

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "WhatsApp Web MCP Server" MCP 服务：
执行：claude mcp add 'io-github-mario-andreschak-mcp-whatsapp-web' -- npx -y mcp-whatsapp-web
```

### Codex
```
请帮我安装 askskill 上的 "WhatsApp Web MCP Server" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-mario-andreschak-mcp-whatsapp-web]
command = "npx"
args = ["-y","mcp-whatsapp-web"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "WhatsApp Web MCP Server" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-mario-andreschak-mcp-whatsapp-web": { "command": "npx", "args": ["-y","mcp-whatsapp-web"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env LOG_LEVEL=YOUR_VALUE --env LOG_STDERR_LEVEL=YOUR_VALUE --env WHATSAPP_HEADLESS=YOUR_VALUE --env BROWSER_EXECUTABLE_PATH=YOUR_VALUE --env WHATSAPP_SESSION_DIR=YOUR_VALUE --env WHATSAPP_PAIRING_PHONE_NUMBER=YOUR_VALUE --env FFMPEG_PATH=YOUR_VALUE --env WA_WEB_VERSION=YOUR_VALUE --env HEALTH_CHECK_INTERVAL_MS=YOUR_VALUE --env TOOL_READY_TIMEOUT_MS=YOUR_VALUE --env MCP_HTTP_PORT=YOUR_VALUE --env MCP_HTTP_HOST=YOUR_VALUE --env MCP_OAUTH=YOUR_VALUE --transport stdio io-github-mario-andreschak-mcp-whatsapp-web -- npx -y mcp-whatsapp-web
```
需要环境变量：LOG_LEVEL, LOG_STDERR_LEVEL, WHATSAPP_HEADLESS, BROWSER_EXECUTABLE_PATH, WHATSAPP_SESSION_DIR, WHATSAPP_PAIRING_PHONE_NUMBER, FFMPEG_PATH, WA_WEB_VERSION, HEALTH_CHECK_INTERVAL_MS, TOOL_READY_TIMEOUT_MS, MCP_HTTP_PORT, MCP_HTTP_HOST, MCP_OAUTH

### Codex
```bash
codex mcp add --env LOG_LEVEL=YOUR_VALUE --env LOG_STDERR_LEVEL=YOUR_VALUE --env WHATSAPP_HEADLESS=YOUR_VALUE --env BROWSER_EXECUTABLE_PATH=YOUR_VALUE --env WHATSAPP_SESSION_DIR=YOUR_VALUE --env WHATSAPP_PAIRING_PHONE_NUMBER=YOUR_VALUE --env FFMPEG_PATH=YOUR_VALUE --env WA_WEB_VERSION=YOUR_VALUE --env HEALTH_CHECK_INTERVAL_MS=YOUR_VALUE --env TOOL_READY_TIMEOUT_MS=YOUR_VALUE --env MCP_HTTP_PORT=YOUR_VALUE --env MCP_HTTP_HOST=YOUR_VALUE --env MCP_OAUTH=YOUR_VALUE io-github-mario-andreschak-mcp-whatsapp-web -- npx -y mcp-whatsapp-web
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-mario-andreschak-mcp-whatsapp-web]
command = "npx"
args = ["-y","mcp-whatsapp-web"]

[mcp_servers.io-github-mario-andreschak-mcp-whatsapp-web.env]
LOG_LEVEL = "YOUR_VALUE"
LOG_STDERR_LEVEL = "YOUR_VALUE"
WHATSAPP_HEADLESS = "YOUR_VALUE"
BROWSER_EXECUTABLE_PATH = "YOUR_VALUE"
WHATSAPP_SESSION_DIR = "YOUR_VALUE"
WHATSAPP_PAIRING_PHONE_NUMBER = "YOUR_VALUE"
FFMPEG_PATH = "YOUR_VALUE"
WA_WEB_VERSION = "YOUR_VALUE"
HEALTH_CHECK_INTERVAL_MS = "YOUR_VALUE"
TOOL_READY_TIMEOUT_MS = "YOUR_VALUE"
MCP_HTTP_PORT = "YOUR_VALUE"
MCP_HTTP_HOST = "YOUR_VALUE"
MCP_OAUTH = "YOUR_VALUE"
```
需要环境变量：LOG_LEVEL, LOG_STDERR_LEVEL, WHATSAPP_HEADLESS, BROWSER_EXECUTABLE_PATH, WHATSAPP_SESSION_DIR, WHATSAPP_PAIRING_PHONE_NUMBER, FFMPEG_PATH, WA_WEB_VERSION, HEALTH_CHECK_INTERVAL_MS, TOOL_READY_TIMEOUT_MS, MCP_HTTP_PORT, MCP_HTTP_HOST, MCP_OAUTH

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-mario-andreschak-mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "LOG_LEVEL": "YOUR_VALUE",
        "LOG_STDERR_LEVEL": "YOUR_VALUE",
        "WHATSAPP_HEADLESS": "YOUR_VALUE",
        "BROWSER_EXECUTABLE_PATH": "YOUR_VALUE",
        "WHATSAPP_SESSION_DIR": "YOUR_VALUE",
        "WHATSAPP_PAIRING_PHONE_NUMBER": "YOUR_VALUE",
        "FFMPEG_PATH": "YOUR_VALUE",
        "WA_WEB_VERSION": "YOUR_VALUE",
        "HEALTH_CHECK_INTERVAL_MS": "YOUR_VALUE",
        "TOOL_READY_TIMEOUT_MS": "YOUR_VALUE",
        "MCP_HTTP_PORT": "YOUR_VALUE",
        "MCP_HTTP_HOST": "YOUR_VALUE",
        "MCP_OAUTH": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-mario-andreschak-mcp-whatsapp-web&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC13aGF0c2FwcC13ZWIiXSwiZW52Ijp7IkxPR19MRVZFTCI6IllPVVJfVkFMVUUiLCJMT0dfU1RERVJSX0xFVkVMIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX0hFQURMRVNTIjoiWU9VUl9WQUxVRSIsIkJST1dTRVJfRVhFQ1VUQUJMRV9QQVRIIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX1NFU1NJT05fRElSIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX1BBSVJJTkdfUEhPTkVfTlVNQkVSIjoiWU9VUl9WQUxVRSIsIkZGTVBFR19QQVRIIjoiWU9VUl9WQUxVRSIsIldBX1dFQl9WRVJTSU9OIjoiWU9VUl9WQUxVRSIsIkhFQUxUSF9DSEVDS19JTlRFUlZBTF9NUyI6IllPVVJfVkFMVUUiLCJUT09MX1JFQURZX1RJTUVPVVRfTVMiOiJZT1VSX1ZBTFVFIiwiTUNQX0hUVFBfUE9SVCI6IllPVVJfVkFMVUUiLCJNQ1BfSFRUUF9IT1NUIjoiWU9VUl9WQUxVRSIsIk1DUF9PQVVUSCI6IllPVVJfVkFMVUUifX0
需要环境变量：LOG_LEVEL, LOG_STDERR_LEVEL, WHATSAPP_HEADLESS, BROWSER_EXECUTABLE_PATH, WHATSAPP_SESSION_DIR, WHATSAPP_PAIRING_PHONE_NUMBER, FFMPEG_PATH, WA_WEB_VERSION, HEALTH_CHECK_INTERVAL_MS, TOOL_READY_TIMEOUT_MS, MCP_HTTP_PORT, MCP_HTTP_HOST, MCP_OAUTH