Connect ChatGPT to WhatsApp
WhatsMCP is a remote MCP server, and ChatGPT reaches it as a connector once Developer mode is on. OAuth is the only way in here — ChatGPT cannot present a custom API key — so the browser sign-in is the whole configuration.
Endpoint : https://api.whatsmcp.com/mcp Auth : OAuth (sign in when prompted)
Add WhatsApp to ChatGPT in 4 steps.
Turn on Developer mode
Custom MCP connectors live behind Developer mode — enable it under Settings → Security and login (availability depends on your ChatGPT plan). This is what exposes the option to add your own connector.
Add WhatsMCP as a connector
Go to Plugins / Connectors, add a new one and paste the full endpoint URL. Leave authentication on OAuth. ChatGPT reads the server metadata, registers itself and sends you to the WhatsMCP console to approve — there is no header field to paste a key into.
URL : https://api.whatsmcp.com/mcp Auth : OAuth
Approve the connection
A browser tab opens on the WhatsMCP sign-in page. Log in and approve access; the tab hands control back to ChatGPT, which keeps the token for you. You can revoke it later from Console → Connections.
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.
Register → https://console.whatsmcp.com/register Personal → Console → Pair device → scan the QR Business → Console → Add a number → Connect with Facebook
What ChatGPT can do once it is connected.
The connection exposes one toolbelt for the whole account. Ask ChatGPT 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).
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 ChatGPT.
- 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 ChatGPT 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.
Connecting ChatGPT to WhatsApp.
How do I add WhatsApp as a ChatGPT MCP connector?
Turn on Developer mode under Settings → Security and login, add a new connector, paste https://api.whatsmcp.com/mcp as the URL, leave authentication on OAuth, and approve the sign-in in the browser. ChatGPT then lists the WhatsMCP tools.
Can ChatGPT use a WhatsMCP API key?
No. ChatGPT cannot present a custom API key to an MCP server — there is no header field for one — so OAuth is the only way in, and the sign-in flow is the whole setup. Use an API key only on clients like Codex or Cursor that let you set a header.
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.
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 Claude
Add WhatsApp to Claude as a remote MCP connector 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 ChatGPT a number.
Get an API key Open consoleFree Personal plan · 7-day free trial for Business (official).