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.