Cursor MCP WhatsApp: 109 Free Tools (Wassenger Alternative)
Want WhatsApp + Mail inside Cursor without an Enterprise MCP plan? Omdaa's free Cursor MCP plugin exposes 109 tools (v2.3.0) over Streamable HTTP — sessions, inbox, groups, bulk, webhooks, Omdaa AI, and Omdaa Mail.
Series: Free Forever WhatsApp Dev · Install: cursor.directory/plugins/omdaa-api
Why this matters in 2026
AI editors are becoming the control plane. Instead of clicking dashboards, you tell the agent:
“Create a WhatsApp session, show QR, set webhook to n8n, and enable Omdaa AI.”
Omdaa MCP does that free forever — a practical alternative to paid WhatsApp MCP offerings.
Install (2 minutes)
- Open Cursor Directory → omdaa-api → Add to Cursor
- Get an API key from Dashboard → API Keys
- Set auth (prefer header, not query string):
{
"mcpServers": {
"Omdaa": {
"url": "https://omdaa.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_OMDAA_API_KEY"
}
}
}
}
- Restart Cursor MCP / reload window
- Ask: “List my Omdaa MCP tools” or call
get_health
What you can do (tool groups)
| Area | Examples |
|---|---|
| Sessions |
create_session, get_qr, get_connection_state, logout_session
|
| Messaging |
send_text_message, send_media, send_buttons, list_chats, get_messages
|
| Groups |
create_group, add_group_participants, get_group_invite_link
|
| Bulk |
create_bulk_campaign, pause_bulk_job, get_bulk_job_status
|
| AI |
upsert_openai_bot, suggest_reply, summarize_chat
|
| Webhooks |
set_webhook, test_webhook, list_webhook_events
|
create_mailbox, send_mail, list_mail_messages (13 mail tools) |
|
| Account |
list_api_keys, get_account_stats, list_integrations
|
Full catalog: docs/MCP-TOOLS.md
Example agent prompts
Create a WhatsApp session named support, return the QR, then pause until connected.
Set webhook to https://omdaa.com/n8n/webhook/omdaa-whatsapp for message.received events and test it.
Send "Hello from Cursor MCP" to 201234567890 on session default.
Create mailbox hello@omdaa.com and show IMAP settings.
Pair with the JS SDK
When you need scripts outside the editor:
npm install @omdaafreeapi/omdaa-api-client
const { OmdaaClient } = require('@omdaafreeapi/omdaa-api-client');
const client = new OmdaaClient({ apiKey: process.env.OMDAA_API_KEY });
await client.webhooks.set({
url: 'https://omdaa.com/n8n/webhook/omdaa-whatsapp',
enabled: true,
events: ['message.received'],
});
Security tips
- Prefer
Authorization: Bearerheaders — avoid?key=in URLs - Rotate keys from Dashboard → API Keys
- Scope bots with least privilege sessions
- Verify webhook HMAC (
X-Webhook-Signature)
Related tutorials
Omdaa MCP — Free Forever. Wassenger-style agent control without Enterprise pricing.
Top comments (0)