Whatsapp Cloud
by codespario.github.codespar/mcp-whatsapp-cloudv0.2.2
MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API
- Runs on your machine
- No known advisories
- MIT
Version checks
- Available on npm, latest 0.2.2 · checked
Not run yet – package checks are being switched on. It runs from a package on your machine, so instead of uptime we will start each new version in our sandbox.
Run it on your machine
Add to claude_desktop_config.json (Settings › Developer › Edit Config):
Add to ~/.cursor/mcp.json:
Add to ~/.config/devin/mcp_config.json:
Add to cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers):
Add to mcp.json (Program › Install › Edit mcp.json):
Add to ~/.gemini/settings.json:
Add to ~/.llm/config.json:
Add to config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows):
Add to resources/assets/config/mcp.json in the installed app:
Add to ~/.boltai/mcp.json:
Add to anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory:
Add to Augment Settings Panel – MCP section – Import from JSON (VS Code extension):
Add to ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project):
Add to ~/.config/eca/config.json (global) or .eca/config.json in the project:
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
Add to ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace):
{
"mcpServers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
} Step by step for Claude Desktop
Step by step for Devin Desktop
Run in a terminal:
claude mcp add --env WHATSAPP_ACCESS_TOKEN=YOUR_WHATSAPP_ACCESS_TOKEN --env WHATSAPP_PHONE_NUMBER_ID=YOUR_WHATSAPP_PHONE_NUMBER_ID --env WHATSAPP_BUSINESS_ACCOUNT_ID=YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID --transport stdio mcp-whatsapp-cloud -- npx -y @codespar/[email protected] Add to .vscode/mcp.json:
{
"servers": {
"mcp-whatsapp-cloud": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
} Add to ~/.config/zed/settings.json:
{
"context_servers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
} Add to ~/.continue/config.yaml:
mcpServers:
- name: "mcp-whatsapp-cloud"
type: stdio
command: "npx"
args:
- "-y"
- "@codespar/[email protected]"
env:
"WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN"
"WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID"
"WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" Add to ~/.config/goose/config.yaml:
extensions:
"mcp-whatsapp-cloud":
type: stdio
name: "mcp-whatsapp-cloud"
enabled: true
cmd: "npx"
args: ["-y", "@codespar/[email protected]"]
env_keys: []
envs: { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
timeout: 300 Run in a terminal:
codex mcp add mcp-whatsapp-cloud --env WHATSAPP_ACCESS_TOKEN=YOUR_WHATSAPP_ACCESS_TOKEN --env WHATSAPP_PHONE_NUMBER_ID=YOUR_WHATSAPP_PHONE_NUMBER_ID --env WHATSAPP_BUSINESS_ACCOUNT_ID=YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID -- npx -y @codespar/[email protected] Add to ~/.config/agenvoy/mcp.json:
{
"servers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
} Add to ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
{
"amp.mcpServers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
} Replace YOUR_WHATSAPP_ACCESS_TOKEN,YOUR_WHATSAPP_PHONE_NUMBER_ID,YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID with your own values.
For agents: the install prompt
Every step above as one Markdown text, for an assistant installing it for you.
# Install the MCP server `io.github.codespar/mcp-whatsapp-cloud`
Its page: https://plug.directory/servers/io.github.codespar/mcp-whatsapp-cloud
It runs on the person's machine and needs Node.js installed.
Ask the person for `YOUR_WHATSAPP_ACCESS_TOKEN`, `YOUR_WHATSAPP_PHONE_NUMBER_ID`, `YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID` and put it in place of the placeholder; never invent a value.
Use the section for the person's client.
## Claude Desktop, Cursor, Devin Desktop, Cline, LM Studio, Gemini CLI, mcp-client-cli, oterm, TUUI, BoltAI, AnythingLLM, Augment Code, Bob Shell, ECA, Kiro, Kiro CLI
Merge into the place for the person's client:
- Claude Desktop: claude_desktop_config.json (Settings › Developer › Edit Config)
- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- mcp-client-cli: ~/.llm/config.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- TUUI: resources/assets/config/mcp.json in the installed app
- BoltAI: ~/.boltai/mcp.json
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)
- Bob Shell: ~/.bob/settings/mcp.json (global) or .bob/mcp.json (project)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project
- Kiro: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)
- Kiro CLI: ~/.kiro/settings/mcp.json (user) or .kiro/settings/mcp.json (workspace)
```json
{
"mcpServers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
}
```
## Claude Code
Run in a terminal:
```sh
claude mcp add --env WHATSAPP_ACCESS_TOKEN=YOUR_WHATSAPP_ACCESS_TOKEN --env WHATSAPP_PHONE_NUMBER_ID=YOUR_WHATSAPP_PHONE_NUMBER_ID --env WHATSAPP_BUSINESS_ACCOUNT_ID=YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID --transport stdio mcp-whatsapp-cloud -- npx -y @codespar/[email protected]
```
## VS Code
Merge into .vscode/mcp.json:
```json
{
"servers": {
"mcp-whatsapp-cloud": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
}
```
## Zed
Merge into ~/.config/zed/settings.json:
```json
{
"context_servers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
}
```
## Continue
Merge into ~/.continue/config.yaml:
```yaml
mcpServers:
- name: "mcp-whatsapp-cloud"
type: stdio
command: "npx"
args:
- "-y"
- "@codespar/[email protected]"
env:
"WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN"
"WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID"
"WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID"
```
## Goose
Merge into ~/.config/goose/config.yaml:
```yaml
extensions:
"mcp-whatsapp-cloud":
type: stdio
name: "mcp-whatsapp-cloud"
enabled: true
cmd: "npx"
args: ["-y", "@codespar/[email protected]"]
env_keys: []
envs: { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
timeout: 300
```
## Codex
Run in a terminal:
```sh
codex mcp add mcp-whatsapp-cloud --env WHATSAPP_ACCESS_TOKEN=YOUR_WHATSAPP_ACCESS_TOKEN --env WHATSAPP_PHONE_NUMBER_ID=YOUR_WHATSAPP_PHONE_NUMBER_ID --env WHATSAPP_BUSINESS_ACCOUNT_ID=YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID -- npx -y @codespar/[email protected]
```
## Agenvoy
Merge into ~/.config/agenvoy/mcp.json:
```json
{
"servers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
}
```
## Amp
Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):
```json
{
"amp.mcpServers": {
"mcp-whatsapp-cloud": {
"command": "npx",
"args": ["-y", "@codespar/[email protected]"],
"env": { "WHATSAPP_ACCESS_TOKEN": "YOUR_WHATSAPP_ACCESS_TOKEN", "WHATSAPP_PHONE_NUMBER_ID": "YOUR_WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_BUSINESS_ACCOUNT_ID": "YOUR_WHATSAPP_BUSINESS_ACCOUNT_ID" }
}
}
}
```
Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.
Known advisories
None known for its packages.
Checked 2026-10-28 against OSV.dev and deps.dev.
From the publisher's entry in the Official MCP Registry (the registry entry)and from npm. We have not checked this server yet. Report a problem