Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@manycontacts/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ManyContacts CLI

Terminal CLI for ManyContacts that allows AI agents (Claude Code, Cowork, etc.) and power users to perform all ManyContacts operations programmatically.

Installation

npm install -g @manycontacts/cli

Or run directly:

npx @manycontacts/cli

Setup

mc auth login --email user@example.com --password mypassword

Register a new account

mc auth register --email user@example.com --name "My Company"

Environment variables

MC_CLI_TOKEN - CLI authentication token (alternative to login)
MC_API_URL - API base URL (default: https://api.manycontacts.com)

Usage

All responses are JSON by default (ideal for AI agent consumption):

{ "ok": true, "data": {...}, "pagination": { "page": 1, "limit": 50, "has_more": true } }

Quick account context

mc context

Returns: organization, connected channels, counters (contacts, users, tags, etc.), active features and modules.

Contact management

mc contacts list --open true --limit 20
mc contacts get +34600000000
mc contacts create --phone "+34600000000" --name "John Smith"
mc contacts update +34600000000 --name "John A. Smith"
mc contacts assign +34600000000 --user <user-id>
mc contacts unassign +34600000000
mc contacts close +34600000000
mc contacts open +34600000000
mc contacts tag-add +34600000000 --tag <tag-id>
mc contacts tag-remove +34600000000 --tag <tag-id>
mc contacts team-add +34600000000 --team <team-id>
mc contacts set-stage +34600000000 --funnel <funnel-id> --stage <stage-id>
mc contacts set-notes +34600000000 --notes "Contact notes"
mc contacts bulk --action close --phones "+34600000000,+34600000001"
mc contacts bulk --action add_tag --phones "+34600000000" --value <tag-id>
mc contacts delete +34600000000

Contact list filters

Filter	Example	Description
`--open`	`--open true`	Filter by open (`true`) or closed (`false`) status
`--assigned-to`	`--assigned-to <user-id>`	Filter by assigned user
`--tags`	`--tags id1,id2`	Contacts that have all specified tags
`--team`	`--team <team-id>`	Contacts assigned to a team
`--stages`	`--stages id1,id2`	Contacts in specific funnel stages
`--date-from`	`--date-from 2026-01-01`	Updated after this date (max 90 days range)
`--date-to`	`--date-to 2026-04-14`	Updated before this date (max 90 days range)
`--unread`	`--unread`	Only contacts with unread messages
`--blacklist`	`--blacklist`	Only blacklisted contacts
`--scheduled`	`--scheduled`	Only contacts with pending scheduled messages

Filters can be combined:

mc contacts list --tags <vip-tag-id> --open true --limit 100
mc contacts list --team <support-team-id> --unread --date-from 2026-01-15 --date-to 2026-04-14

Messaging

mc messages list +34600000000 --limit 20
mc messages get +34600000000 <message-id>
mc messages send text +34600000000 --body "Hello, how can we help you?"
mc messages send note +34600000000 --body "Internal team note"
mc messages send media +34600000000 --file ./document.pdf --caption "Attachment"
mc messages send template +34600000000 --template <template-id> --vars '["John"]'
mc messages read +34600000000 <message-id>

Templates

mc templates list
mc templates list --status approved
mc templates get <template-id>
mc templates sync

The list command shows all visible templates with their name, code, status, components and media flags. Use --status to filter by approved, pending or rejected. The sync command fetches the latest templates from the WhatsApp (Meta Cloud API) account.

Teams

mc teams list
mc teams create --name "Support"
mc teams add-member <team-id> --user <user-id>
mc teams remove-member <team-id> --user <user-id>
mc teams delete <id>

Funnels / Pipelines

mc funnels list
mc funnels create --name "Sales"
mc funnels add-stage <funnel-id> --name "Contacted" --order 1
mc funnels update-stage <funnel-id> <stage-id> --name "Negotiating"
mc funnels delete-stage <funnel-id> <stage-id> --move-to <other-stage-id>
mc funnels contacts <funnel-id>
mc funnels delete <id>

Custom fields

mc custom-fields list
mc custom-fields create --name "Company" --type text
mc custom-fields update <id> --name "Organization"
mc custom-fields delete <id>

Quick replies

mc short-responses list
mc short-responses create --name "greeting" --text "Hello! How can I help you?"
mc short-responses update <id> --text "Updated text"
mc short-responses delete <id>

AI agents

mc ai-agents list
mc ai-agents create --name "Assistant" --instructions "You are a sales assistant..."
mc ai-agents get <id>
mc ai-agents update <id> --active true --instructions "New instructions..."
mc ai-agents feedback <id>
mc ai-agents delete <id>

Channels

mc channels list
mc channels connect whatsapp-api
mc channels connect whatsapp-coexistence
mc channels connect whatsapp-qr
mc channels whatsapp-profile
mc channels update-whatsapp-profile --about "Our company" --description "Description"
mc channels delete <id>

The connect command returns a URL that must be opened in a browser. Each channel type follows a different flow:

whatsapp-qr: Shows a QR code to scan with WhatsApp on your phone.
whatsapp-api: Opens a Meta embedded signup popup to authorize the WhatsApp Business API.
whatsapp-coexistence: Same as whatsapp-api but for the Coexistence mode.

mc widget get
mc widget get-code
mc widget update --name "My Widget"

Organization

mc org get
mc org update --timezone "Europe/Madrid" --auto-reply-open true
mc org schedule get
mc org schedule update --data '[{"day":1,"start":"09:00","end":"18:00","active":true}]'
mc org apikey
mc org checklist
mc org empty --confirm

Users and permissions

mc users list
mc users get <id>
mc users update <id> --name "New name"
mc users invite --email "new@company.com"
mc users invitations
mc users revoke-invitation <id>
mc users permissions-schema
mc users delete <id>

Campaigns

mc campaigns list
mc campaigns create --name "Black Friday" --template <template-id> --phones "+34600000000,+34600000001,+34600000002" --date "2026-11-27T10:00:00"
mc campaigns create --name "Promo" --template <id> --phones "+34600000000" --date "2026-12-01T09:00:00" --variables '["John","20%"]'
mc campaigns delete <id>

Billing

mc billing subscriptions
mc billing checkout

Email

mc email status
mc email folders
mc email list
mc email get <id>
mc email send --to "user@example.com" --subject "Subject" --body "<p>Content</p>"
mc email disconnect

CLI tokens

mc auth whoami
mc auth token-list
mc auth token-create --name "CI/CD Pipeline" --scopes "contacts:read,messages:read"
mc auth token-revoke <token-id>
mc auth token-rotate <token-id>
mc auth logout

Security

CLI tokens are stored hashed (SHA-256) in the database
Granular scopes: account:read, account:write, contacts:read, contacts:write, messages:read, messages:write, campaigns:read, campaigns:write, settings:read, settings:write, ai:read, ai:write, email:read, email:write, *
7-day free trial: after trial expiration, a paid subscription is required to continue using the CLI
Rate limit: 60 requests/minute (paid accounts), 10 requests/minute (free accounts within trial)
Optional IP allowlist per token
Optional token expiration
Audit log for all operations
All operations are scoped to the token's organization

For AI agents

The CLI is designed to be used by AI agents:

JSON output: all responses are parseable JSON
mc context: quick summary of the account state
mc --help: documentation for all commands
Consistent error codes: { "ok": false, "error": "message" }
--quiet: suppresses spinners and colors for clean parsing