Back to Browse
Free
Server data from the Official MCP Registry
WhatsApp Business MCP: send messages, manage contacts, campaigns, and AI agents.
About
WhatsApp Business MCP: send messages, manage contacts, campaigns, and AI agents.
Security Report
3.0
Use Caution3.0High RiskValid MCP server (2 strong, 2 medium validity signals). 5 known CVEs in dependencies (2 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 6 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.
Unverified package source
We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.
What You'll Need
Set these up before or after installing:
ManyContacts CLI authentication token. Get one at https://manycontacts.com or via: npx @manycontacts/cli auth loginRequired
Environment variable: MC_CLI_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-manycontacts-whatsapp-mcp": {
"env": {
"MC_CLI_TOKEN": "your-mc-cli-token-here"
},
"args": [
"-y",
"@manycontacts/mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
ManyContacts MCP Server
MCP (Model Context Protocol) server for ManyContacts — the WhatsApp Business CRM. Enables AI agents (Claude, Cursor, Windsurf, etc.) to manage contacts, send WhatsApp messages, run campaigns, configure AI auto-replies, and perform all CRM operations programmatically.
Quick Start
1. Get your CLI token
npm install -g @manycontacts/cli
Already have an account? Log in:
mc auth login --email user@example.com --password mypassword
mc auth whoami # verify it works
New to ManyContacts? Create an account and connect your WhatsApp channel:
# Register a new account
mc auth register --email user@example.com --name "My Company"
# Connect a WhatsApp Business channel (choose one method):
mc channels connect whatsapp-api # WhatsApp Cloud API (recommended)
mc channels connect coexistence # ManyContacts coexistence mode
mc channels connect qr # QR code pairing
# Verify everything is set up
mc auth whoami
mc channels list
2. Configure in your MCP client
Claude Desktop / Claude Code
Add to your MCP settings (~/.claude/claude_desktop_config.json or similar):
{
"mcpServers": {
"manycontacts": {
"command": "npx",
"args": ["@manycontacts/mcp"],
"env": {
"MC_CLI_TOKEN": "your-cli-token-here"
}
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"manycontacts": {
"command": "npx",
"args": ["@manycontacts/mcp"],
"env": {
"MC_CLI_TOKEN": "your-cli-token-here"
}
}
}
}
Tip: If you've already logged in via the CLI (
mc auth login), the token is stored in~/.manycontacts/config.jsonand the MCP server will pick it up automatically — noMC_CLI_TOKENenv var needed.
Available Tools (55 total)
Account & Context
manycontacts.context
Get a full overview of your ManyContacts account: connected WhatsApp Business channels, contact/user/tag counts, active AI agents, and enabled features. Use this first to understand the account state before performing other operations.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.org.get
Get WhatsApp Business organization/account information including name, timezone, and all configuration settings.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.org.update
Update organization-level settings such as timezone, auto-reply messages, auto-close behavior, and webhook configuration.
| Parameter | Type | Required | Description |
|---|---|---|---|
timezone | string | No | Timezone identifier (e.g. Europe/Madrid, America/New_York) |
auto_reply_open | boolean | No | Enable auto-reply when a new chat is opened |
auto_reply_open_text | string | No | Auto-reply message text when chat opens |
auto_reply_close | boolean | No | Enable auto-reply when a chat is closed |
auto_reply_close_text | string | No | Auto-reply message text when chat closes |
auto_reply_close_minutes | number | No | Minutes of inactivity before auto-close |
auto_reply_away | boolean | No | Enable away/out-of-hours auto-reply |
auto_reply_away_text | string | No | Away auto-reply message text |
webhooks_forward | boolean | No | Enable webhook forwarding to an external URL |
webhooks_forward_url | string | No | External URL to forward webhook events to |
manycontacts.org.schedule.get
Get the business hours schedule. Returns the configured working hours for each day of the week, used to determine when the "away" auto-reply activates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.org.apikey
Get the organization's REST API key for direct API integrations.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.channels.list
List all connected WhatsApp Business and Instagram channels. For WhatsApp channels, shows the phone number and connection status. For Instagram channels, shows the username.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
Contacts
All contact operations use phone numbers as identifiers (with country code, no + prefix, e.g. 34600000000).
manycontacts.contacts.list
List WhatsApp Business contacts with advanced filters. Returns paginated results with has_more indicator. Filters can be combined freely.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | number | No | Page number (default: 1) |
limit | number | No | Results per page, max 200 (default: 50) |
open | "true" | "false" | No | Filter by conversation open/closed status |
assigned_to | string | No | Filter by assigned user ID |
tags | string | No | Comma-separated tag IDs — contacts must have all specified tags |
team | string | No | Filter by team ID |
stages | string | No | Comma-separated funnel stage IDs |
date_from | string | No | Filter contacts updated after this date (YYYY-MM-DD) |
date_to | string | No | Filter contacts updated before this date (YYYY-MM-DD) |
unread | "true" | No | Only contacts with unread messages |
blacklist | "true" | No | Only blacklisted contacts |
scheduled | "true" | No | Only contacts with pending scheduled messages |
Note: When using
date_fromanddate_totogether, the range cannot exceed 90 days.
Response:
{
"ok": true,
"data": [
{
"name": "John Doe",
"number": "34600000000",
"open": true,
"last_user_id": "uuid-of-assigned-user",
"source": "whatsapp",
"notes": "VIP customer",
"customFields": {},
"createdAt": "2026-01-15T10:30:00Z"
}
],
"pagination": { "page": 1, "limit": 50, "has_more": true }
}
manycontacts.contacts.get
Get detailed information about a specific contact including their tags, teams, funnel stages, and custom fields.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number with country code (e.g. 34600000000) |
manycontacts.contacts.create
Create a new WhatsApp Business contact in the CRM. The phone number will be normalized automatically (leading + removed).
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number with country code (e.g. 34600000000) |
name | string | No | Contact display name |
notes | string | No | Free-text notes for the contact |
manycontacts.contacts.update
Update an existing contact's name, notes, or custom fields.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact to update |
name | string | No | New contact name |
notes | string | No | New contact notes |
customFields | string | No | Custom fields as a JSON string (e.g. '{"company":"Acme"}') |
manycontacts.contacts.delete
Permanently delete a contact from the CRM.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact to delete |
manycontacts.contacts.assign
Assign a contact to a specific team member. The assigned user will see this contact in their personal inbox.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
userId | string | Yes | User ID to assign the contact to (use manycontacts.users.list to get IDs) |
manycontacts.contacts.unassign
Remove the current user assignment from a contact. The contact returns to the general unassigned inbox.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
manycontacts.contacts.close
Close a WhatsApp conversation. Closed conversations are archived and won't appear in the active inbox.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
manycontacts.contacts.open
Reopen a previously closed WhatsApp conversation. The contact will appear again in the active inbox.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
manycontacts.contacts.tag.add
Add a tag to a contact. Use manycontacts.tags.list to get available tag IDs.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
tagId | string | Yes | Tag ID to add |
manycontacts.contacts.tag.remove
Remove a tag from a contact.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
tagId | string | Yes | Tag ID to remove |
manycontacts.contacts.team.add
Add a team to a contact. Use manycontacts.teams.list to get available team IDs.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
teamId | string | Yes | Team ID to add |
manycontacts.contacts.team.remove
Remove a team from a contact.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
teamId | string | Yes | Team ID to remove |
manycontacts.contacts.set_stage
Move a contact to a specific stage within a sales funnel/pipeline. Use manycontacts.funnels.list to get funnel and stage IDs.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
funnel_id | string | Yes | Funnel ID |
stage_id | string | Yes | Target stage ID within the funnel |
manycontacts.contacts.bulk
Perform bulk operations on multiple contacts at once. Supports closing, opening, assigning, tagging, and team assignment.
| Parameter | Type | Required | Description |
|---|---|---|---|
action | "close" | "open" | "assign" | "add_tag" | "add_team" | Yes | Bulk action to perform |
phones | string | Yes | Comma-separated phone numbers (e.g. "34600000000,34600000001") |
value | string | No | Value required by the action: user ID for assign, tag ID for add_tag, team ID for add_team. Not needed for close or open. |
Messaging
manycontacts.messages.list
List WhatsApp conversation messages for a contact. Returns messages in a conversation-friendly format with timestamps, status, and sender information.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
page | number | No | Page number (default: 1) |
limit | number | No | Messages per page (default: 50) |
manycontacts.messages.send.text
Send a WhatsApp text message to a contact. Only works within the 24-hour conversation window. Use manycontacts.messages.send.template to initiate conversations outside this window.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number to send the message to |
body | string | Yes | Message text content |
manycontacts.messages.send.note
Create an internal note on a contact's conversation. Notes are only visible to team members and are not sent to the WhatsApp contact.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number of the contact |
body | string | Yes | Internal note text |
manycontacts.messages.send.template
Send a WhatsApp Business template message. Templates are required to initiate conversations outside the 24-hour window or for bulk outbound messaging. Templates must be pre-approved by Meta.
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Phone number to send the template to |
templateId | string | Yes | Template ID (use manycontacts.templates.list to get IDs) |
variables | string | No | Template variables as a JSON array string (e.g. '["John","20%"]') |
Templates
WhatsApp Business templates are pre-approved message formats required for outbound messaging outside the 24-hour conversation window.
manycontacts.templates.list
List all WhatsApp Business message templates. Shows template name, code, status, components, and media flags.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | "approved" | "pending" | "rejected" | No | Filter templates by approval status |
manycontacts.templates.get
Get full details of a specific template including its components (header, body, footer, buttons), configuration, and media attachments.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Template ID |
manycontacts.templates.sync
Sync WhatsApp Business templates from Meta Cloud API. Fetches the latest templates from the connected WhatsApp Business account. Useful after creating or modifying templates in the Meta Business Manager.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
Campaigns
Campaigns allow bulk sending of WhatsApp template messages to a list of phone numbers at a scheduled time.
manycontacts.campaigns.list
List all WhatsApp Business bulk messaging campaigns with statistics (sent, delivered, read, and failed counts), template names, and scheduled dates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.campaigns.create
Create a new WhatsApp Business bulk messaging campaign. The campaign will send a template message to the specified phone numbers at the scheduled time.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Campaign name |
templateId | string | Yes | WhatsApp template ID to use (must be approved) |
phones | string | Yes | Comma-separated phone numbers (e.g. "34600000000,34600000001,34600000002") |
date | string | Yes | Scheduled send date in ISO format (e.g. "2026-12-01T09:00:00") |
variables | string | No | Template variables as a JSON array string (e.g. '["John","20%"]') |
manycontacts.campaigns.delete
Delete a WhatsApp Business campaign. Only pending (not yet sent) campaigns can be deleted.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Campaign ID to delete |
Tags
Tags are colored labels used to categorize and filter WhatsApp Business contacts (e.g. "VIP", "Support", "Lead").
manycontacts.tags.list
List all available tags with their names, colors, and IDs.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.tags.create
Create a new tag for categorizing contacts.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Tag name |
color | string | No | Tag color as hex code (e.g. "#ff0000"). Defaults to #fab1a0 |
manycontacts.tags.update
Update an existing tag's name or color.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Tag ID to update |
name | string | No | New tag name |
color | string | No | New tag color as hex code |
manycontacts.tags.delete
Delete a tag. The tag will be removed from all contacts that have it.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Tag ID to delete |
Teams
Teams group users together for assignment routing and contact organization.
manycontacts.teams.list
List all teams in the organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.teams.create
Create a new team.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Team name |
manycontacts.teams.add_member
Add a user to a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
teamId | string | Yes | Team ID |
userId | string | Yes | User ID to add to the team |
manycontacts.teams.remove_member
Remove a user from a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
teamId | string | Yes | Team ID |
userId | string | Yes | User ID to remove from the team |
manycontacts.teams.delete
Delete a team. Team members are not deleted, only the team grouping.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Team ID to delete |
Sales Funnels / Pipelines
Funnels allow you to track contacts through a multi-stage sales or support pipeline (e.g. "New Lead" -> "Qualified" -> "Proposal" -> "Won").
manycontacts.funnels.list
List all sales funnels/pipelines with their stages.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.funnels.create
Create a new sales funnel/pipeline.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Funnel name |
manycontacts.funnels.add_stage
Add a new stage to an existing funnel.
| Parameter | Type | Required | Description |
|---|---|---|---|
funnelId | string | Yes | Funnel ID |
name | string | Yes | Stage name (e.g. "Qualified", "Proposal Sent") |
order | number | Yes | Stage position in the pipeline (0-based) |
manycontacts.funnels.update_stage
Update a stage's name within a funnel.
| Parameter | Type | Required | Description |
|---|---|---|---|
funnelId | string | Yes | Funnel ID |
stageId | string | Yes | Stage ID to update |
name | string | No | New stage name |
manycontacts.funnels.contacts
List contacts currently in a specific funnel, optionally filtered by stage. Returns paginated results.
| Parameter | Type | Required | Description |
|---|---|---|---|
funnelId | string | Yes | Funnel ID |
stage_id | string | No | Filter by specific stage ID |
page | number | No | Page number |
limit | number | No | Results per page |
manycontacts.funnels.delete
Delete a sales funnel/pipeline and all its stages. Contacts in the funnel are not deleted.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Funnel ID to delete |
Users / Team Members
Manage the team members who have access to the WhatsApp Business CRM.
manycontacts.users.list
List all team members/users in the organization with their roles and details.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.users.get
Get details of a specific team member.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | User ID |
manycontacts.users.update
Update a team member's profile information.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | User ID to update |
name | string | No | New user display name |
manycontacts.users.invite
Invite a new team member to the organization by email. They will receive an invitation email to join.
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Email address to send the invitation to |
manycontacts.users.delete
Remove a team member from the organization. Their assigned contacts will become unassigned.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | User ID to remove |
AI Agents
AI agents auto-respond to incoming WhatsApp messages using configurable instructions and scenarios. Only active agents are listed.
manycontacts.ai_agents.list
List all active AI auto-reply agents with their configuration.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
manycontacts.ai_agents.get
Get full details of a specific AI agent including its scenarios (conversation flows), instruction blocks, and configuration.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | AI Agent ID (UUID) |
manycontacts.ai_agents.update
Update an AI agent's configuration. You can enable/disable the agent or modify its instruction blocks.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | AI Agent ID (UUID) |
active | boolean | No | Enable (true) or disable (false) the agent |
block_1 | string | No | Agent instructions — block 1 |
block_2 | string | No | Agent instructions — block 2 |
block_3 | string | No | Agent instructions — block 3 |
manycontacts.ai_agents.feedback
Get feedback and conversation logs for an AI agent. Shows how the agent has been responding and user satisfaction data.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | AI Agent ID (UUID) |
Available Prompts (6 total)
Pre-built prompts that guide AI agents through common workflows. Use these to quickly accomplish multi-step tasks.
contact-lookup
Look up a WhatsApp contact and get a complete summary of their profile, tags, funnel stage, and recent messages.
| Argument | Required | Description |
|---|---|---|
phone | Yes | Phone number in international format (e.g. +34612345678) |
send-campaign
Step-by-step guide to creating a WhatsApp bulk campaign: lists available templates, asks for recipients and schedule, then creates the campaign.
| Argument | Required | Description |
|---|---|---|
| (none) | — | Interactive guided workflow |
daily-dashboard
Generates a complete overview of your ManyContacts account including channels, open conversations, team structure, and sales funnels.
| Argument | Required | Description |
|---|---|---|
| (none) | — | No arguments needed |
reply-to-contact
Reviews recent conversation history with a contact, then sends a WhatsApp message with full context.
| Argument | Required | Description |
|---|---|---|
phone | Yes | Phone number in international format (e.g. +34612345678) |
message | Yes | The message text to send |
manage-funnel
Displays all sales funnels with their stages and contact counts per stage, giving a visual pipeline overview.
| Argument | Required | Description |
|---|---|---|
| (none) | — | No arguments needed |
bulk-tag-contacts
Tags multiple contacts at once — finds or creates the tag, then applies it in bulk.
| Argument | Required | Description |
|---|---|---|
phones | Yes | Comma-separated phone numbers (e.g. +34612345678,+34698765432) |
tagName | Yes | Name of the tag to apply |
Environment Variables
| Variable | Required | Description |
|---|---|---|
MC_CLI_TOKEN | Yes* | ManyContacts CLI authentication token. Get one via mc auth login. |
MC_API_URL | No | API base URL (default: https://api.manycontacts.com) |
*If you've logged in via the CLI, the token is stored locally at
~/.manycontacts/config.jsonand the MCP server reads it automatically.
Authentication
The MCP server authenticates using CLI tokens. Each token is scoped to an organization and has configurable permissions.
# Login to get a token
mc auth login --email user@example.com --password mypassword
# The token is stored at ~/.manycontacts/config.json
# Or set it explicitly via environment variable:
export MC_CLI_TOKEN=your-token-here
Rate Limits
- Paying accounts: 60 requests/minute
- Free/trial accounts: 10 requests/minute
When rate limited, the server returns a 429 error with a link to upgrade.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Communication MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI
1.6K
Stars
11
Installs
7.0
Security
No ratings yet
Local