Skip to content

Commit 850d7f2

Browse files
authored
Merge pull request #632 from cursor/liam-ilan/whatsapp-business
[whatsapp-business] Add WhatsApp Business plugin
2 parents 6ce45c5 + 9729a65 commit 850d7f2

7 files changed

Lines changed: 178 additions & 0 deletions

File tree

‎.cursor-plugin/marketplace.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -518,6 +518,11 @@
518518
"source": "third_party/workday",
519519
"description": "Look up workers, organizations, time off, payroll, and recruiting data in Workday."
520520
},
521+
{
522+
"name": "whatsapp-business",
523+
"source": "third_party/whatsapp-business",
524+
"description": "Send messages and manage templates, contacts, and phone numbers in WhatsApp Business."
525+
},
521526
{
522527
"name": "square",
523528
"source": "third_party/square",

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
9595
| `shopify-store` | [Shopify](third_party/shopify-store/) | Cursor | Integrations | Connect your Shopify store so Grok can answer questions about products, orders, customers, inventory, and sales. |
9696
| `quickbooks-online` | [QuickBooks Online](third_party/quickbooks-online/) | Cursor | Integrations | Read invoices, bills, expenses, customers, accounts, and financial reports. |
9797
| `workday` | [Workday](third_party/workday/) | Cursor | Integrations | Look up workers, organizations, time off, payroll, and recruiting data in Workday. |
98+
| `whatsapp-business` | [WhatsApp Business](third_party/whatsapp-business/) | Cursor | Integrations | Send messages and manage templates, contacts, and phone numbers in WhatsApp Business. |
9899
| `square` | [Square](third_party/square/) | Cursor | Integrations | Work with payments, orders, catalog, customers, and invoices. |
99100
| `tailscale` | [Tailscale](third_party/tailscale/) | Cursor | Integrations | Let Grok Bot reach MCP servers on your private Tailscale network. Sign in to Tailscale to connect your tailnet; Grok Bot joins it as one tagged device and only reaches the hosts you grant to tag:grokbot. |
100101
| `highlevel` | [HighLevel](third_party/highlevel/) | Cursor | Integrations | Work with contacts, conversations, opportunities, calendars, and payments. |
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
{
2+
"name": "whatsapp-business",
3+
"displayName": "WhatsApp Business",
4+
"version": "1.0.0",
5+
"minClientVersions": {
6+
"cursor": "3.19.0"
7+
},
8+
"description": "Send messages and manage templates, contacts, and phone numbers in WhatsApp Business.",
9+
"author": {
10+
"name": "Cursor",
11+
"email": "plugins@cursor.com"
12+
},
13+
"homepage": "https://github.com/cursor/plugins/tree/main/third_party/whatsapp-business",
14+
"repository": "https://github.com/cursor/plugins",
15+
"license": "MIT",
16+
"logo": "assets/logo.png",
17+
"keywords": [
18+
"whatsapp",
19+
"whatsapp business",
20+
"meta",
21+
"messaging",
22+
"mcp"
23+
],
24+
"category": "integrations",
25+
"tags": [
26+
"whatsapp",
27+
"whatsapp business",
28+
"meta",
29+
"messaging",
30+
"mcp"
31+
],
32+
"variables": {
33+
"type": "object",
34+
"additionalProperties": false,
35+
"required": [
36+
"WHATSAPP_BUSINESS_ACCOUNT_ID",
37+
"WHATSAPP_BUSINESS_PHONE_NUMBER_ID",
38+
"WHATSAPP_BUSINESS_ACCESS_TOKEN"
39+
],
40+
"properties": {
41+
"WHATSAPP_BUSINESS_ACCOUNT_ID": {
42+
"type": "string",
43+
"title": "WhatsApp Business Account ID",
44+
"description": "Shown next to your account name in WhatsApp Manager.",
45+
"minLength": 1
46+
},
47+
"WHATSAPP_BUSINESS_PHONE_NUMBER_ID": {
48+
"type": "string",
49+
"title": "Phone number ID",
50+
"description": "The long numeric ID under Account tools > Phone numbers in WhatsApp Manager, not the phone number itself.",
51+
"minLength": 1
52+
},
53+
"WHATSAPP_BUSINESS_ACCESS_TOKEN": {
54+
"type": "string",
55+
"title": "Access token",
56+
"description": "A system user token with the whatsapp_business_messaging and whatsapp_business_management permissions.",
57+
"writeOnly": true,
58+
"format": "password",
59+
"minLength": 1
60+
}
61+
}
62+
}
63+
}
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Changelog
2+
3+
All notable changes to this plugin will be documented here.
4+
5+
## 1.0.0 — initial release
6+
7+
- Added the `whatsapp-business` plugin, the opt-in for the WhatsApp Business MCP server that Cursor hosts.
8+
- Carries no MCP server definition: the server is Cursor-side, so installing the plugin is the whole configuration.
9+
- Each member enters their own `WHATSAPP_BUSINESS_ACCOUNT_ID`, `WHATSAPP_BUSINESS_PHONE_NUMBER_ID`, and `WHATSAPP_BUSINESS_ACCESS_TOKEN`. These are per-member values, not team settings.
10+
- The access token is a Meta system user token with the `whatsapp_business_messaging` and `whatsapp_business_management` permissions.
11+
- Logo: WhatsApp's official mark, from `whatsapp.com`.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Cursor
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
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
9.51 KB
Loading

0 commit comments

Comments
 (0)