Claude MarketplacesSubmit
adelaidasofia avatar

WhatsApp MCP

adelaidasofia/whatsapp-mcp

Connects Claude to WhatsApp via the whatsmeow protocol with a local Go bridge and Python MCP layer. Read chats and contacts, search messages with accent-insensitive matching, transcribe voice notes locally through whisper.cpp, and send texts with a mandatory two-step confirmation flow. SQLCipher encrypts the database at rest with keys in macOS Keychain, and every inbound message passes through a prompt injection scrubber before Claude sees it. Daily CI runs govulncheck and pip-audit. Reach for this when you need WhatsApp integrated into Claude workflows but can't accept the prompt injection and instant-send risks of lighter implementations. Ships with audit logging and no telemetry.

tools
55
auth
Secret needed
transport
STDIO
env vars
9
last updated
May 20, 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)

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

WHATSAPP_BRIDGE_HOSTdefault: 127.0.0.1

Hostname for the Go bridge REST API.

WHATSAPP_BRIDGE_PORTdefault: 8080

Port for the Go bridge REST API.

WHATSAPP_VAULT_CRM_PATH

Absolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.

WHATSAPP_WHISPER_BACKENDdefault: local-cpp

Voice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).

WHATSAPP_WHISPER_API_KEYsecret

OpenAI API key. Required only when WHATSAPP_WHISPER_BACKEND=openai-api.

WHATSAPP_WHISPER_MODELdefault: large-v3

whisper.cpp model name. Only used when backend is local-cpp.

WHATSAPP_SCRUB_PROMPT_INJECTIONdefault: true

Strip known prompt-injection patterns from incoming messages before the LLM sees them.

WHATSAPP_AUDIT_LOGdefault: true

Log every tool call to audit.log.

WHATSAPP_ENCRYPT_DBdefault: true

Enable SQLCipher DB encryption with the key sourced from macOS Keychain.

Readme

whatsapp-mcp

View the full README on GitHub

Details

Repository
github.com/adelaidasofia/whatsapp-mcp
Categories
Communication & Messaging, Media & Entertainment
Package
adelaidasofia-whatsapp-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from adelaidasofia

Related Communication & Messaging MCP servers

View all
1danushkumar-v avatarDanushkumar V Mcp Discorddanushkumar-v/mcp-discordAn MCP server that integrates with Discord to provide AI-powered features.0stars
2sebastianall1977 avatarSebastianall1977 Gmail Mcpsebastianall1977/gmail-mcpManage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…0stars
3mumo-chat avatarmumomumo-chat/mumo-mcpMulti-model deliberation over MCP: full responses plus typed cross-model reactions from other labs.0stars
4deva avatarDilli Email Validation Api Servercom.dillilabs.deva/dilli-email-validation-api-serverAn MCP server that provides tools to validate an email address using Dilli Email Validation API.0stars
5gitsim avatarGitsim Chatcom.gitsim/chatSearch, order, and manage eSIM data packages for 190+ countries.0stars
6themailx avatarMailX Email Deliverabilitycom.themailx/email-deliverabilityCheck SPF/DKIM/DMARC/BIMI, blacklists, SMTP/IMAP; DNS lookups; generate email DNS records.0stars