Connect

Connect Claude to WhatsApp

WhatsMCP is a remote Model Context Protocol server, so Claude connects to it as a custom connector — in Claude Desktop, claude.ai or Claude Code. OAuth is the default: the connector discovers the flow from the endpoint and signs you in through the WhatsMCP console.

Get an API key Open console Read the docs
shell 
claude mcp add --transport http wamcp https://api.whatsmcp.com/mcp
# then run /mcp inside Claude Code and pick Authenticate
Setup

Add WhatsApp to Claude in 4 steps.

1

Claude Desktop & claude.ai

Open Settings → Connectors → Add custom connector, put the endpoint in the URL field, and leave Authentication on OAuth. Claude discovers the flow and signs you in. The auth type is fixed when the connector is added, so pick OAuth now — switching later means deleting and re-adding it.

custom connector 
URL  : https://api.whatsmcp.com/mcp
Auth : OAuth
2

Claude Code

One command adds the server; then authenticate. Claude resolves the OAuth authorization server from the endpoint's own metadata, so you only ever type the endpoint URL.

shell 
claude mcp add --transport http wamcp https://api.whatsmcp.com/mcp
# run /mcp → Authenticate, or: claude mcp login wamcp
claude mcp list   # should show wamcp connected
3

Prefer an API key?

In the Desktop connector dialog set Authentication to None and add x-api-key: YOUR_KEY under additional headers (Authorization is reserved there for Claude's own OAuth token). In Claude Code, pass --header "Authorization: Bearer YOUR_KEY" on the add command.

Connect a WhatsApp number

Create a free workspace, then connect a number. A Personal number pairs by QR: open Pair device in the console and scan the code with your phone (WhatsApp → Settings → Linked devices). WhatsMCP joins as a linked device — your phone stays primary. A Business (official) Cloud API number connects from the console instead; one connector serves both.

console 
Register  →  https://console.whatsmcp.com/register
Personal  →  Console → Pair device → scan the QR
Business  →  Console → Add a number → Connect with Facebook
Capabilities

What Claude can do once it is connected.

The connection exposes one toolbelt for the whole account. Ask Claude in plain language and it calls the right tool — starting with wa_list_accounts for the account id every other tool takes.

Send and reply

Send and answer messages as the connected number — text, images, documents and voice notes — in direct chats, groups and channels, with edits and reactions.

Read and search

Page message history by cursor with no gaps or duplicates, catch up on a chat, and resolve "message Alice" against the synced address book.

Handle media

Download received images, documents and audio by message id, and attach files on the way out.

Manage groups

Create groups, add and remove members, promote and demote admins, join by invite link and follow channels.

Inspect calls

Export call history — direction, peer, duration, answered state and codec — for logging or follow-up.

Receive webhooks

Push each inbound message to your own HTTPS endpoint, signed with HMAC-SHA256, instead of polling for it (paid plans).

Trial & limits

Free to start, honest about the rest.

  • Free Personal plan — self-serve, no card, one linked number. Enough to connect a number and drive it from Claude.
  • Business (official) runs on Meta's WhatsApp Cloud API with message templates and the 24-hour window, on a 7-day free trial — same endpoint, same Claude setup.
  • Plan-scoped tools — which tools appear in the client depends on your plan; an excluded tool is absent, not present-and-refusing. Webhooks and higher send caps are on paid plans.
  • Independent integration — not affiliated with or endorsed by Meta. Automating a Personal number carries the usual WhatsApp terms-of-service risk; the number can be rate-limited or blocked. Remove WhatsMCP any time with wa_unpair_account .
FAQ

Connecting Claude to WhatsApp.

How do I add WhatsApp as a Claude connector?

In Claude Desktop or claude.ai, open Settings → Connectors → Add custom connector, set the URL to https://api.whatsmcp.com/mcp, leave Authentication on OAuth, and sign in. In Claude Code, run claude mcp add --transport http wamcp https://api.whatsmcp.com/mcp and then authenticate with /mcp.

Does the Claude connector need an API key?

No — OAuth is the default and nothing is pasted or stored; you approve the connection in the browser. An API key is only the fallback: in Desktop set Authentication to None and add x-api-key: YOUR_KEY, or in Claude Code pass --header "Authorization: Bearer YOUR_KEY".

What is the WhatsMCP endpoint URL?

The full URL https://api.whatsmcp.com/mcp — the api. host and the /mcp path both matter. Giving a client the bare host (whatsmcp.com, or whatsmcp.com/mcp) is the most common setup failure; it is a remote Streamable-HTTP MCP server, not a stdio command.

Do I need an API key, or is OAuth enough?

OAuth is recommended and is what every supported client does by default — you approve the connection in the browser and nothing is pasted or stored. An API key (wamcp_live_…) over Authorization: Bearer, or x-api-key where a client reserves Authorization for its own token, is the fallback for CLIs, CI and clients that cannot sign in.

Does this use a Personal or a Business WhatsApp number?

Either, through the same endpoint. A Personal number pairs by QR as a linked device (free plan, one number). A Business (official) number runs on Meta's WhatsApp Cloud API, connects from the console, and adds message templates and the 24-hour window on a 7-day free trial. See /whatsapp-business-api for the official path.

Is this an official WhatsApp or Meta product?

No. WhatsMCP is an independent integration, not affiliated with or endorsed by Meta. A Personal number connects as a linked device, the same mechanism as WhatsApp Web, and you can remove it any time from the handset or with wa_unpair_account.

More connectors

Connect another AI client.

Same endpoint, same OAuth sign-in. See the full list.

Connect Codex

Give the OpenAI Codex CLI a real WhatsApp number over a remote MCP server.

Connect Grok

Point a Grok-powered agent at a WhatsApp number through the MCP endpoint.

Connect ChatGPT

Add WhatsApp as a ChatGPT connector in Developer mode, over OAuth.

Connect Cursor

Add WhatsApp to Cursor so the Agent can read and reply to your chats.

Connect Manus

Connect the Manus AI agent to a WhatsApp number through the MCP endpoint.

Give Claude a number.

Get an API key Open console

Free Personal plan · 7-day free trial for Business (official).