|
| 1 | +# WhatsApp Business |
| 2 | + |
| 3 | +Cursor plugin that connects agents to [WhatsApp Business](https://business.whatsapp.com) — Meta's messaging platform for businesses — through a [Model Context Protocol](https://modelcontextprotocol.io/) server that Cursor hosts. |
| 4 | + |
| 5 | +Work with a WhatsApp Business Account: send messages from your business phone number, manage message templates, and look up contacts and phone numbers. |
| 6 | + |
| 7 | +## Install |
| 8 | + |
| 9 | +1. Open **Cursor Settings → Plugins**. |
| 10 | +2. Search for **WhatsApp Business** and click **Install**. |
| 11 | +3. Enter your WhatsApp Business Account ID, phone number ID, and access token (see [Before you connect](#before-you-connect)). |
| 12 | + |
| 13 | +Or run `/add-plugin whatsapp-business` in chat. |
| 14 | + |
| 15 | +## MCP |
| 16 | + |
| 17 | +This plugin ships no `mcp.json`, and that is deliberate. |
| 18 | + |
| 19 | +Every other connector in this repository either points at a vendor's hosted endpoint or runs a package locally over stdio, so it carries its own server definition. WhatsApp Business does not: Cursor runs the server, and the plugin exists only as the opt-in that turns it on for your account. There is no command to run and no MCP endpoint to configure. |
| 20 | + |
| 21 | +One consequence worth knowing: because the server is not declared here, you will not find it in a local `mcp.json` and you cannot point another MCP client at it. It is reachable from Cursor only. |
| 22 | + |
| 23 | +## Before you connect |
| 24 | + |
| 25 | +Each person who installs the plugin enters their own three values. These are per-member settings, so a team admin cannot set them for everyone. |
| 26 | + |
| 27 | +### 1. Create a system user token in Meta |
| 28 | + |
| 29 | +1. In [Meta Business Suite](https://business.facebook.com), open **Business settings → Users → System users** and add a system user, or pick an existing one. |
| 30 | +2. Under **Assign assets**, give the system user access to your WhatsApp Business Account. |
| 31 | +3. Click **Generate new token**, choose the Meta app connected to your WhatsApp Business Account, and select the `whatsapp_business_messaging` and `whatsapp_business_management` permissions. |
| 32 | +4. Copy the token. Meta shows it only once. |
| 33 | + |
| 34 | +### 2. Find your IDs in WhatsApp Manager |
| 35 | + |
| 36 | +- **WhatsApp Business Account ID:** shown next to your account name in [WhatsApp Manager](https://business.facebook.com/wa/manage/home/). |
| 37 | +- **Phone number ID:** the long numeric ID under **Account tools → Phone numbers**. Use the ID, not the phone number itself. |
| 38 | + |
| 39 | +### 3. Enter the values in Cursor |
| 40 | + |
| 41 | +All three fields are required: |
| 42 | + |
| 43 | +| Field | Value | |
| 44 | +| --- | --- | |
| 45 | +| `WHATSAPP_BUSINESS_ACCOUNT_ID` | WhatsApp Business Account ID from WhatsApp Manager. | |
| 46 | +| `WHATSAPP_BUSINESS_PHONE_NUMBER_ID` | Phone number ID from **Account tools → Phone numbers**. Agents send messages from this number. | |
| 47 | +| `WHATSAPP_BUSINESS_ACCESS_TOKEN` | The system user token from step 1. Treated as a secret and never shown back. | |
| 48 | + |
| 49 | +## What agents can do |
| 50 | + |
| 51 | +| Category | Capabilities | |
| 52 | +| --- | --- | |
| 53 | +| Messages | Send text and template messages from your business phone number | |
| 54 | +| Templates | List and manage message templates | |
| 55 | +| Contacts | Look up the contacts your business messages | |
| 56 | +| Phone numbers | Read the phone numbers on your WhatsApp Business Account | |
| 57 | + |
| 58 | +The server is the source of truth for tool names and schemas. |
| 59 | + |
| 60 | +## Notes |
| 61 | + |
| 62 | +- Access follows the system user token. The connector can reach only the WhatsApp Business Accounts assigned to that system user, within the token's permissions. |
| 63 | +- WhatsApp only allows free-form messages within 24 hours of a customer's last message. Outside that window, agents must send an approved template. |
| 64 | +- Messages go out from your real business number and can incur Meta's messaging charges. Review what agents send. |
| 65 | +- Disconnecting the connector in Cursor deletes your saved account ID, phone number ID, and access token. Revoking the token in Meta Business Settings ends Cursor's access to your account. |
| 66 | + |
| 67 | +## Docs |
| 68 | + |
| 69 | +- WhatsApp Business Platform: https://business.whatsapp.com |
| 70 | +- WhatsApp Cloud API: https://developers.facebook.com/docs/whatsapp/cloud-api |
| 71 | +- Model Context Protocol: https://modelcontextprotocol.io |
| 72 | + |
| 73 | +Logo is WhatsApp's official mark, from `whatsapp.com`. |
| 74 | + |
| 75 | +## License |
| 76 | + |
| 77 | +MIT |
0 commit comments