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.
WhatsApp Business CRM: send messages, manage contacts, campaigns, and AI agents.
MC_CLI_TOKEN
ตรวจสอบล่าสุด
2026-11-09
ดาว
—
เครื่องมือ
—
อัปไทม์
—
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):
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.
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.
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.
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.