MCP, MCP server
Whatsapp Mcp Extended
An extended Model Context Protocol (MCP) server for WhatsApp with a toolset-gated, agent-facing surface for messaging, search, media, group management, webhooks, presence, and more.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
Rescanned at commit e365961e30d5, unchanged since the check below.
PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- PERMISSION_DELETE_FILES Low
Contains a call that can delete files.
whatsapp-mcp-server/audio.py, line 61
subprocess.run(cmd, capture_output=True, text=True, check=True) - NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
whatsapp-bridge/main.go, line 449
fmt.Println(" curl -H 'X-API-Key: " - NETWORK_UNNAMED_HOST Low
Calls a fixed host that the description does not name.
whatsapp-bridge/main.go, line 449
fmt.Println(" curl -H 'X-API-Key: " - SECRETS_PATH_DOTENV Low
Mentions a .env file.
bin-run-bridge.sh, line 3
# Launch the WhatsApp bridge with its .env, for the launchd KeepAlive wrapper. - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
whatsapp-bridge/main.go, line 96
apiKey := os.Getenv("API_KEY") - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
whatsapp-mcp-server/uv.lock, line 1
version = 1
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Concern
can delete files.
PERMISSION_DELETE_FILES
whatsapp-mcp-server/audio.py, line 61
subprocess.run(cmd, capture_output=True, text=True, check=True)
whatsapp-mcp-server/check.py, line 22
result = subprocess.run(cmd)
whatsapp-mcp-server/check.py, line 35
result = subprocess.run([sys.executable, "-m", "py_compile", f])
Show more
whatsapp-mcp-server/whatsapp.py, line 1077
os.remove(temp_path)
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address. can reach attacker.com. The description does not name that host.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST
whatsapp-bridge/main.go, line 449
fmt.Println(" curl -H 'X-API-Key: "
whatsapp-mcp-server/whatsapp.py, line 965
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
whatsapp-mcp-server/whatsapp.py, line 1051
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
Show more
whatsapp-mcp-server/whatsapp.py, line 1107
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
whatsapp-mcp-server/whatsapp.py, line 1144
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
whatsapp-mcp-server/whatsapp.py, line 1498
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
whatsapp-mcp-server/whatsapp.py, line 1551
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
whatsapp-mcp-server/whatsapp.py, line 1605
response = requests.post(url, json=payload, headers=_get_headers(), timeout=30)
docs/SECURITY_AUDIT.md, line 675
fetch('http://localhost:8180/api/webhooks')
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
bin-run-bridge.sh, line 3
# Launch the WhatsApp bridge with its .env, for the launchd KeepAlive wrapper.
bin-run-bridge.sh, line 7
set -a; . "$DIR/.env"; set +a
whatsapp-bridge/main.go, line 96
apiKey := os.Getenv("API_KEY")
Show more
setup.ps1, line 9
2. Copies .env.example -> .env if .env is missing
setup.ps1, line 27
$ENV_FILE = Join-Path $ProjectPath ".env"
setup.ps1, line 28
$ENV_EXAMPLE = Join-Path $ProjectPath ".env.example"
setup.ps1, line 57
# ── 2. .env bootstrap ─────────────────────────────────────────────────────────
setup.ps1, line 61
Write-Host "[OK] Created .env from .env.example - edit it to set API_KEY" -ForegroundColor Green
setup.ps1, line 64
Write-Host "[WARN] No .env.example found - create $ENV_FILE manually" -ForegroundColor Yellow
whatsapp-bridge/internal/api/middleware.go, line 50
expectedKey := os.Getenv("API_KEY")
whatsapp-mcp-server/main.py, line 788
api_key = os.getenv("API_KEY") or os.getenv("WHATSAPP_API_KEY")
whatsapp-mcp-server/lib/bridge.py, line 37
api_key = os.getenv("API_KEY") or os.getenv("WHATSAPP_API_KEY")
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read.
OBFUSCATION_FILE_OVER_READ_CAP
whatsapp-mcp-server/uv.lock, line 1
version = 1
whatsapp-web-ui/package-lock.json, line 1
{
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit e365961e30d5. can delete files. can reach a host that is not written as a fixed address. can reach attacker.com. The description does not name that host. reads a credential or environment file. a file was over the read cap and was not fully read.
Date and source
Date checked:
github.com
Commit graded: e365961e30d50bd42b0aaa7d9539222285258c53
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.