io.github.gaviwhatsapp/whatsapp
Send WhatsApp messages from Cursor, Claude Code, and Codex via MCP.
Ask AI about io.github.gaviwhatsapp/whatsapp
Powered by Claude · Grounded in docs
I know everything about io.github.gaviwhatsapp/whatsapp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Gavi WhatsApp API
The WhatsApp API built for how developers actually build in 2026. Works in Cursor, Claude Code, Codex, and Lovable.
MCP server · TypeScript SDK · Python SDK · Examples · $9.99/mo
What is this?
A complete WhatsApp Business API platform with:
- MCP Server — Type "send a WhatsApp message" in Cursor or Claude Code and it just works
- REST API — 6 endpoints: send message, send template, send media, broadcasts, webhooks, contacts
- TypeScript SDK —
npm install @gaviwhatsapp/whatsapp - Python SDK —
pip install gaviwhatsapp - Dashboard — Visual form builder, conversation flows, broadcast campaigns, analytics
Quick Start
Option 1: MCP Server (AI coding tools)
Add to .cursor/mcp.json or .claude/mcp.json:
{
"mcpServers": {
"gaviwhatsapp": {
"command": "npx",
"args": ["@gaviwhatsapp/mcp", "--api-key", "gv_YOUR_KEY"]
}
}
}
Then just ask: "Send a WhatsApp message to +919876543210 saying hello"
Option 2: TypeScript SDK
npm install @gaviwhatsapp/whatsapp
import { WhatsApp } from '@gaviwhatsapp/whatsapp'
const wa = new WhatsApp({ apiKey: process.env.GAVIWHATSAPP_API_KEY! })
await wa.send({ to: '+919876543210', text: 'Hello from my app!' })
Option 3: Python SDK
pip install gaviwhatsapp
from gaviwhatsapp import WhatsApp
wa = WhatsApp(api_key="gv_YOUR_KEY")
wa.send(to="+919876543210", text="Hello from my app!")
Option 4: REST API
curl -X POST https://www.gaviventures.com/api/v1/messages \
-H "Authorization: Bearer gv_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "+919876543210", "text": "Hello!"}'
Get an API Key
- Sign up at gaviventures.com
- Connect your WhatsApp Business Account
- Go to Settings > API Keys
Packages
| Package | Description | Install |
|---|---|---|
@gaviwhatsapp/mcp | MCP server for Cursor, Claude Code, Codex | npx @gaviwhatsapp/mcp |
@gaviwhatsapp/whatsapp | TypeScript/Node.js SDK | npm install @gaviwhatsapp/whatsapp |
gaviwhatsapp | Python SDK | pip install gaviwhatsapp |
Examples
| Example | Description | Language |
|---|---|---|
| send-message-ts | Send a text message | TypeScript |
| send-message-python | Send a text message | Python |
| broadcast-campaign | Send personalized broadcast from CSV | TypeScript |
| webhook-receiver | Receive incoming WhatsApp messages | TypeScript |
API Reference
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/messages | Send a text message |
| POST | /api/v1/messages/template | Send a template message |
| POST | /api/v1/messages/media | Send media (image/video/document) |
| POST | /api/v1/broadcasts | Send to multiple recipients |
| POST | /api/v1/webhooks | Register a webhook |
| GET | /api/v1/webhooks | List webhooks |
Full docs: gaviventures.com/docs/api
Pricing
| Plan | Price | Includes |
|---|---|---|
| API | $9.99/mo | API, SDKs, MCP server, webhooks, broadcasts |
| Pro | $24.99/mo | Everything + visual builder, forms, flows, analytics |
7-day free trial. No credit card required. Meta per-message charges billed directly to your WhatsApp Business Account.
Links
License
Source code in this repository is provided for reference and integration purposes. The WhatsApp API service requires a paid subscription. See gaviventures.com for terms.
