How do I install ManyContacts WhatsApp Business MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ManyContacts WhatsApp Business MCP need an API key?

The publisher lists these environment variables: MC_CLI_TOKEN.

What transport does ManyContacts WhatsApp Business MCP use?

ManyContacts WhatsApp Business MCP runs locally over stdio.

When was ManyContacts WhatsApp Business MCP last checked?

Last checked 2026-11-09. WhatsApp Business MCP: send messages, manage contacts, campaigns, and AI agents.

ManyContacts WhatsApp Business MCP server

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 [email protected] --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 [email protected] --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.json and the MCP server will pick it up automatically — no MC_CLI_TOKEN env 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_from and date_to together, 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

Parameter	Type	Required	Description
`name`	`string`	Yes	Tag name
`color`	`string`	No	Tag color as hex code (e.g. `"#ff0000"`). Defaults to `#fab1a0`

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

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.json and 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 [email protected] --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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install ManyContacts WhatsApp Business MCP?

Does ManyContacts WhatsApp Business MCP need an API key?

What transport does ManyContacts WhatsApp Business MCP use?

When was ManyContacts WhatsApp Business MCP last checked?

Documentation

ManyContacts MCP Server

Quick Start

1. Get your CLI token

2. Configure in your MCP client

Claude Desktop / Claude Code

Cursor

Available Tools (55 total)

Account & Context

manycontacts.context

manycontacts.org.get

manycontacts.org.update

manycontacts.org.schedule.get

manycontacts.org.apikey

manycontacts.channels.list

Contacts

manycontacts.contacts.list

manycontacts.contacts.get

manycontacts.contacts.create

manycontacts.contacts.update

manycontacts.contacts.delete

manycontacts.contacts.assign

manycontacts.contacts.unassign

manycontacts.contacts.close

manycontacts.contacts.open

manycontacts.contacts.tag.add

manycontacts.contacts.tag.remove

manycontacts.contacts.team.add

manycontacts.contacts.team.remove

manycontacts.contacts.set_stage

manycontacts.contacts.bulk

Messaging

manycontacts.messages.list

manycontacts.messages.send.text

manycontacts.messages.send.note

manycontacts.messages.send.template

Templates

manycontacts.templates.list

manycontacts.templates.get

manycontacts.templates.sync

Campaigns

manycontacts.campaigns.list

manycontacts.campaigns.create

manycontacts.campaigns.delete

Tags

manycontacts.tags.list

manycontacts.tags.create

manycontacts.tags.update

manycontacts.tags.delete