Back to Browse

Gaviwhatsapp MCP Server

CommunicationUse Caution4.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

Send WhatsApp messages from Cursor, Claude Code, and Codex via MCP.

About

Send WhatsApp messages from Cursor, Claude Code, and Codex via MCP.

Security Report

4.8
Use Caution4.8High Risk

This is a well-structured WhatsApp API MCP server with proper authentication, clean code quality, and appropriate permission scoping. The server requires API key authentication for all operations, uses secure credential handling via environment variables, and has no malicious patterns or dangerous operations. Minor issues include lack of input validation on URL formats and some error handling gaps, but these are low-severity and do not impact the overall security posture. Supply chain analysis found 7 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

8 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your API key for the serviceRequired

Environment variable: YOUR_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-gaviwhatsapp-whatsapp": {
      "env": {
        "YOUR_API_KEY": "your-your-api-key-here"
      },
      "args": [
        "-y",
        "@gaviwhatsapp/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

npm npm PyPI


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 SDKnpm install @gaviwhatsapp/whatsapp
  • Python SDKpip 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

  1. Sign up at gaviventures.com
  2. Connect your WhatsApp Business Account
  3. Go to Settings > API Keys

Packages

PackageDescriptionInstall
@gaviwhatsapp/mcpMCP server for Cursor, Claude Code, Codexnpx @gaviwhatsapp/mcp
@gaviwhatsapp/whatsappTypeScript/Node.js SDKnpm install @gaviwhatsapp/whatsapp
gaviwhatsappPython SDKpip install gaviwhatsapp

Examples

ExampleDescriptionLanguage
send-message-tsSend a text messageTypeScript
send-message-pythonSend a text messagePython
broadcast-campaignSend personalized broadcast from CSVTypeScript
webhook-receiverReceive incoming WhatsApp messagesTypeScript

API Reference

MethodEndpointDescription
POST/api/v1/messagesSend a text message
POST/api/v1/messages/templateSend a template message
POST/api/v1/messages/mediaSend media (image/video/document)
POST/api/v1/broadcastsSend to multiple recipients
POST/api/v1/webhooksRegister a webhook
GET/api/v1/webhooksList webhooks

Full docs: gaviventures.com/docs/api

Pricing

PlanPriceIncludes
API$9.99/moAPI, SDKs, MCP server, webhooks, broadcasts
Pro$24.99/moEverything + 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.

Reviews

No reviews yet

Be the first to review this server!