Whatsapp Mcp

meharajm/whatsapp-mcp

Enables Claude to ping you on WhatsApp for runtime approval or status updates when you're away from your desk. Authenticate once via QR code, then the agent can call ask_question to block execution until you reply from your phone, send_message for one-way notifications, or disconnect to invalidate the session. Useful when you want an autonomous agent making consequential changes but need a human gate at decision points. Uses Baileys under the hood for WhatsApp Web protocol. You can lock down which numbers can respond (helpful for group chats) and the connection persists across restarts. Pair it with a .cursorrules prompt instructing Claude to ask via WhatsApp instead of the IDE chat when permission is needed.

tools: 55
auth: Required
transport: STDIO
env vars: 2
last updated: Mar 25, 2026

View on GitHub

Tools

55 tools

Public tool metadata for what this MCP can expose to an agent.

manycontacts.contextGet ManyContacts account overview: WhatsApp Business channels, contact/user/tag counts, active AI agents, and enabled features. Use this first to understand the account state.

Get ManyContacts account overview: WhatsApp Business channels, contact/user/tag counts, active AI agents, and enabled features. Use this first to understand the account state.

No parameter schema in public metadata yet.

manycontacts.contacts.listList WhatsApp Business contacts with filters (tags, team, date, unread, blacklist, scheduled). Returns paginated results.12 params

List WhatsApp Business contacts with filters (tags, team, date, unread, blacklist, scheduled). Returns paginated results.

Parameters* required

assigned_tostring

Filter by assigned user ID

blackliststring

Set to 'true' for only blacklisted contacts

date_fromstring

Filter updated after date (YYYY-MM-DD)

date_tostring

Filter updated before date (YYYY-MM-DD, max 90 days range)

limitnumber

Results per page, max 200 (default 50)

openstring

Filter by open/closed status: 'true' or 'false'

pagenumber

Page number (default 1)

scheduledstring

Set to 'true' for only contacts with pending scheduled messages

stagesstring

Comma-separated funnel stage IDs

tagsstring

Comma-separated tag IDs (contacts must have ALL tags)

teamstring

Filter by team ID

unreadstring

Set to 'true' for only contacts with unread messages

manycontacts.contacts.getGet detailed information about a WhatsApp Business contact including tags, teams, and funnel stages.1 params

Get detailed information about a WhatsApp Business contact including tags, teams, and funnel stages.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.createCreate a new WhatsApp Business contact in ManyContacts CRM.3 params

Create a new WhatsApp Business contact in ManyContacts CRM.

Parameters* required

namestring

Contact display name

notesstring

Internal notes about the contact

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.updateUpdate an existing WhatsApp Business contact (name, notes, custom fields).4 params

Update an existing WhatsApp Business contact (name, notes, custom fields).

Parameters* required

customFieldsstring

Custom fields as JSON string

namestring

New contact name

notesstring

New contact notes

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.deleteDelete a WhatsApp Business contact from ManyContacts CRM.1 params

Delete a WhatsApp Business contact from ManyContacts CRM.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.assignAssign a WhatsApp Business contact to a team member.2 params

Assign a WhatsApp Business contact to a team member.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

userIdstring

User ID to assign the contact to

manycontacts.contacts.unassignUnassign a WhatsApp Business contact (remove current user assignment).1 params

Unassign a WhatsApp Business contact (remove current user assignment).

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.closeClose a WhatsApp Business conversation.1 params

Close a WhatsApp Business conversation.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.openReopen a closed WhatsApp Business conversation.1 params

Reopen a closed WhatsApp Business conversation.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.contacts.tag.addAdd a tag to a WhatsApp Business contact.2 params

Add a tag to a WhatsApp Business contact.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

tagIdstring

Tag ID to add

manycontacts.contacts.tag.removeRemove a tag from a WhatsApp Business contact.2 params

Remove a tag from a WhatsApp Business contact.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

tagIdstring

Tag ID to remove

manycontacts.contacts.team.addAdd a team to a WhatsApp Business contact.2 params

Add a team to a WhatsApp Business contact.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

teamIdstring

Team ID to add

manycontacts.contacts.team.removeRemove a team from a WhatsApp Business contact.2 params

Remove a team from a WhatsApp Business contact.

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

teamIdstring

Team ID to remove

manycontacts.contacts.set_stageMove a WhatsApp Business contact to a funnel/pipeline stage.3 params

Move a WhatsApp Business contact to a funnel/pipeline stage.

Parameters* required

funnel_idstring

Funnel ID

phonestring

Phone number with country code, e.g. 34600000000

stage_idstring

Stage ID within the funnel

manycontacts.contacts.bulkPerform bulk operations on multiple WhatsApp Business contacts (close, open, assign, add_tag, add_team).3 params

Perform bulk operations on multiple WhatsApp Business contacts (close, open, assign, add_tag, add_team).

Parameters* required

actionstring

Bulk action: close, open, assign, add_tag, or add_team

phonesstring

Comma-separated phone numbers

valuestring

Value for action (user_id for assign, tag_id for add_tag, team_id for add_team)

manycontacts.messages.listList WhatsApp Business messages for a contact. Shows the conversation history with timestamps and status.3 params

List WhatsApp Business messages for a contact. Shows the conversation history with timestamps and status.

Parameters* required

limitnumber

Messages per page (default 50)

pagenumber

Page number (default 1)

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.messages.send.textSend a WhatsApp Business text message to a phone number.2 params

Send a WhatsApp Business text message to a phone number.

Parameters* required

bodystring

Message text to send

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.messages.send.noteSend an internal note on a WhatsApp Business contact (not visible to the contact).2 params

Send an internal note on a WhatsApp Business contact (not visible to the contact).

Parameters* required

bodystring

Internal note text

phonestring

Phone number with country code, e.g. 34600000000

manycontacts.messages.send.templateSend a WhatsApp Business template message (for outbound messaging outside the 24h window).3 params

Send a WhatsApp Business template message (for outbound messaging outside the 24h window).

Parameters* required

phonestring

Phone number with country code, e.g. 34600000000

templateIdstring

Template ID to send

variablesstring

Template variables as JSON array, e.g. '["John","20%"]'

manycontacts.templates.listList WhatsApp Business message templates. Templates are required for sending messages outside the 24h conversation window.1 params

List WhatsApp Business message templates. Templates are required for sending messages outside the 24h conversation window.

Parameters* required

statusstring

Filter by template status: approved, pending, or rejected

manycontacts.templates.getGet details of a specific WhatsApp Business message template including components and configuration.1 params

Get details of a specific WhatsApp Business message template including components and configuration.

Parameters* required

idstring

Template ID

manycontacts.templates.syncSync WhatsApp Business templates from Meta Cloud API. Fetches the latest templates from the connected WhatsApp Business account.

Sync WhatsApp Business templates from Meta Cloud API. Fetches the latest templates from the connected WhatsApp Business account.

No parameter schema in public metadata yet.

manycontacts.campaigns.listList WhatsApp Business bulk messaging campaigns with statistics (sent, delivered, read, failed counts).

List WhatsApp Business bulk messaging campaigns with statistics (sent, delivered, read, failed counts).

No parameter schema in public metadata yet.

manycontacts.campaigns.createCreate a WhatsApp Business bulk messaging campaign. Sends a template message to a list of phone numbers at a scheduled time.5 params

Create a WhatsApp Business bulk messaging campaign. Sends a template message to a list of phone numbers at a scheduled time.

Parameters* required

datestring

Scheduled send date in ISO format, e.g. 2026-12-01T09:00:00

namestring

Campaign name

phonesstring

Comma-separated phone numbers to send to

templateIdstring

WhatsApp template ID to use

variablesstring

Template variables as JSON array, e.g. '["John","20%"]'

manycontacts.campaigns.deleteDelete a WhatsApp Business campaign.1 params

Delete a WhatsApp Business campaign.

Parameters* required

idstring

Campaign ID to delete

manycontacts.org.getGet WhatsApp Business organization/account information (name, timezone, settings).

Get WhatsApp Business organization/account information (name, timezone, settings).

No parameter schema in public metadata yet.

manycontacts.org.updateUpdate WhatsApp Business organization settings (timezone, auto-reply, webhooks, etc.).10 params

Update WhatsApp Business organization settings (timezone, auto-reply, webhooks, etc.).

Parameters* required

auto_reply_awayboolean

Enable away auto-reply

auto_reply_away_textstring

Away auto-reply text

auto_reply_closeboolean

Enable auto-reply on chat close

auto_reply_close_minutesnumber

Minutes before auto-close

auto_reply_close_textstring

Auto-reply text when chat closes

auto_reply_openboolean

Enable auto-reply on chat open

auto_reply_open_textstring

Auto-reply text when chat opens

timezonestring

Timezone, e.g. Europe/Madrid

webhooks_forwardboolean

Enable webhook forwarding

webhooks_forward_urlstring

Webhook forward URL

manycontacts.org.schedule.getGet the business hours schedule for the WhatsApp Business account.

Get the business hours schedule for the WhatsApp Business account.

No parameter schema in public metadata yet.

manycontacts.org.apikeyGet the organization API key.

Get the organization API key.

No parameter schema in public metadata yet.

manycontacts.channels.listList connected WhatsApp Business and Instagram channels.

List connected WhatsApp Business and Instagram channels.

No parameter schema in public metadata yet.

manycontacts.tags.listList all tags for categorizing WhatsApp Business contacts.

List all tags for categorizing WhatsApp Business contacts.

No parameter schema in public metadata yet.

manycontacts.tags.createCreate a new tag for WhatsApp Business contacts.2 params

Create a new tag for WhatsApp Business contacts.

Parameters* required

colorstring

Tag color hex, e.g. #ff0000 (default #fab1a0)

namestring

Tag name

manycontacts.tags.updateUpdate an existing WhatsApp Business contact tag.3 params

Update an existing WhatsApp Business contact tag.

Parameters* required

colorstring

New tag color hex

idstring

Tag ID

namestring

New tag name

manycontacts.tags.deleteDelete a WhatsApp Business contact tag.1 params

Delete a WhatsApp Business contact tag.

Parameters* required

idstring

Tag ID to delete

manycontacts.teams.listList teams in the WhatsApp Business organization.

List teams in the WhatsApp Business organization.

No parameter schema in public metadata yet.

manycontacts.teams.createCreate a new team in the WhatsApp Business organization.1 params

Create a new team in the WhatsApp Business organization.

Parameters* required

namestring

Team name

manycontacts.teams.add_memberAdd a user to a team.2 params

Add a user to a team.

Parameters* required

teamIdstring

Team ID

userIdstring

User ID to add

manycontacts.teams.remove_memberRemove a user from a team.2 params

Remove a user from a team.

Parameters* required

teamIdstring

Team ID

userIdstring

User ID to remove

manycontacts.teams.deleteDelete a team from the WhatsApp Business organization.1 params

Delete a team from the WhatsApp Business organization.

Parameters* required

idstring

Team ID to delete

manycontacts.funnels.listList sales funnels/pipelines for organizing WhatsApp Business contacts by stage.

List sales funnels/pipelines for organizing WhatsApp Business contacts by stage.

No parameter schema in public metadata yet.

manycontacts.funnels.createCreate a new sales funnel/pipeline for WhatsApp Business contacts.1 params

Create a new sales funnel/pipeline for WhatsApp Business contacts.

Parameters* required

namestring

Funnel name

manycontacts.funnels.add_stageAdd a stage to a sales funnel/pipeline.3 params

Add a stage to a sales funnel/pipeline.

Parameters* required

funnelIdstring

Funnel ID

namestring

Stage name

ordernumber

Stage order position

manycontacts.funnels.update_stageUpdate a stage in a sales funnel/pipeline.3 params

Update a stage in a sales funnel/pipeline.

Parameters* required

funnelIdstring

Funnel ID

namestring

New stage name

stageIdstring

Stage ID to update

manycontacts.funnels.contactsList contacts in a funnel/pipeline, optionally filtered by stage.4 params

List contacts in a funnel/pipeline, optionally filtered by stage.

Parameters* required

funnelIdstring

Funnel ID

limitnumber

Results per page

pagenumber

Page number

stage_idstring

Filter by stage ID

manycontacts.funnels.deleteDelete a sales funnel/pipeline.1 params

Delete a sales funnel/pipeline.

Parameters* required

idstring

Funnel ID to delete

manycontacts.users.listList team members/users in the WhatsApp Business organization.

List team members/users in the WhatsApp Business organization.

No parameter schema in public metadata yet.

manycontacts.users.getGet details of a specific team member/user.1 params

Get details of a specific team member/user.

Parameters* required

idstring

User ID

manycontacts.users.updateUpdate a team member/user profile.2 params

Update a team member/user profile.

Parameters* required

idstring

User ID

namestring

User name

manycontacts.users.inviteInvite a new team member to the WhatsApp Business organization.1 params

Invite a new team member to the WhatsApp Business organization.

Parameters* required

emailstring

Email address to invite

manycontacts.users.deleteRemove a team member from the WhatsApp Business organization.1 params

Remove a team member from the WhatsApp Business organization.

Parameters* required

idstring

User ID to remove

manycontacts.ai_agents.listList AI agents configured to auto-respond to WhatsApp Business messages.

List AI agents configured to auto-respond to WhatsApp Business messages.

No parameter schema in public metadata yet.

manycontacts.ai_agents.getGet details of a specific WhatsApp AI agent including scenarios and configuration.1 params

Get details of a specific WhatsApp AI agent including scenarios and configuration.

Parameters* required

idstring

AI Agent ID (UUID)

manycontacts.ai_agents.updateUpdate a WhatsApp AI agent's configuration (instructions, active status, etc.).5 params

Update a WhatsApp AI agent's configuration (instructions, active status, etc.).

Parameters* required

activeboolean

Enable or disable the agent

block_1string

Agent instructions block 1

block_2string

Agent instructions block 2

block_3string

Agent instructions block 3

idstring

AI Agent ID (UUID)

manycontacts.ai_agents.feedbackGet feedback/conversation logs for a WhatsApp AI agent.1 params

Get feedback/conversation logs for a WhatsApp AI agent.

Parameters* required

idstring

AI Agent ID (UUID)

Configuration

WHATSAPP_TARGET_NUMBER*

Target WhatsApp number (required)

WHATSAPP_ALLOWED_NUMBERS

Comma-separated JIDs to restrict who can control replies

Readme

WhatsApp MCP Logo

WhatsApp MCP

Human-in-the-Loop for AI Agents via WhatsApp

This is an MCP (Model Context Protocol) server that enables AI agents (like Claude or Cursor) to interact directly with you via WhatsApp. It bridges the gap between your autonomous AI and your phone, allowing for runtime confirmations, permission requests, or simple status updates while you are away from your computer.

AI agent messaging
AI agent confirmations
Agent interrupt system
AI alerts
MCP server
Cursor MCP
Claude Desktop MCP
AI notifications

Perfect for

Cursor
Claude Desktop
Claude Code
OpenCode
Codex
Autonomous AI workflows

Example

View the full README on GitHub

Details

Repository: github.com/meharajm/whatsapp-mcp
Category: Communication & Messaging
Package: @mhrj/whatsapp-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Communication & Messaging MCP servers

View all

Sms Ru Mcptheyahia/sms-ru-mcpMCP server for SMS.RU API — send SMS, check status, balance. 3 tools.0stars

Agent-Native Chatbuilderio/agent-nativeMinimal chat-first app with durable threads, actions, and the app-agent loop7.6Kstars

WhatsApplharries/whatsapp-mcpExposes a MCP server to search, read, and send WhatsApp messages and media via Claude5.6Kstars

Slackkorotovsky/slack-mcp-serverProvides Slack workspace access via MCP with channels, DMs, history, search, and safe posting via multiple transports.1.6Kstars

Hex Linelevnikolaevich/claude-code-skillsHash-verified file editing MCP server with token efficiency hook for AI coding agents.0stars

Discordsaseq/discord-mcpA MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automatio310stars