--- title: "Connect ChatGPT to WhatsApp — MCP Connector | WhatsMCP" description: "Add WhatsApp to ChatGPT as an MCP connector. Turn on Developer mode, paste the WhatsMCP endpoint, sign in with OAuth, and ChatGPT can send and read WhatsApp." url: "https://whatsmcp.com/connect/chatgpt" --- Connect # 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. [Get an API key](https://console.whatsmcp.com/register?utm_source=landing&utm_medium=cta&utm_campaign=connect-chatgpt) [Read the docs](https://whatsmcp.com/docs/mcp) connector ``` Endpoint : https://api.whatsmcp.com/mcp Auth : OAuth (sign in when prompted) ``` Setup ## Add WhatsApp to ChatGPT in 4 steps. 1 ### 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. 2 ### 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. connector ``` URL : https://api.whatsmcp.com/mcp Auth : OAuth ``` 3 ### 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. console ``` Register → https://console.whatsmcp.com/register Personal → Console → Pair device → scan the QR Business → Console → Add a number → Connect with Facebook ``` Capabilities ## 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). 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 ChatGPT. - Business (official) runs on Meta's WhatsApp Cloud API with message templates and the 24-hour window, on a [7-day free trial](https://whatsmcp.com/whatsapp-business-api) — 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` . FAQ ## 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. ## Give ChatGPT a number. [Get an API key](https://console.whatsmcp.com/register?utm_source=landing&utm_medium=cta&utm_campaign=connect-chatgpt) Free Personal plan · 7-day free trial for Business (official).