MCP-manychat
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-manychat list all my tags"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ManyChat MCP Server
MCP (Model Context Protocol) server for ManyChat API integration. Enables Claude and other LLMs to manage ManyChat accounts, subscribers, tags, custom fields, flows, and messaging.
Features
14 MCP tools across 5 domains
Bearer authentication with automatic rate limit retry (429 handling)
Type-safe with Zod schema validation
Read-only and write operations with proper annotations
Comprehensive error handling with actionable messages
Related MCP server: mautic-mcp
Tools
Page & Configuration (3 tools)
manychat_page_info— Get account status, page name, connected channelsmanychat_list_flows— List all automation flows with IDs and namesmanychat_list_growth_tools— List comment triggers, ad tools, widgets
Tags (4 tools)
manychat_list_tags— List all tagsmanychat_create_tag— Create a new tagmanychat_tag_subscriber— Add tag to subscriber by namemanychat_untag_subscriber— Remove tag from subscriber by name
Custom Fields (3 tools)
manychat_list_custom_fields— List all custom fieldsmanychat_create_custom_field— Create custom field (text, number, date, datetime, boolean)manychat_set_field— Set custom field value for subscriber by name
Subscribers (3 tools)
manychat_get_subscriber— Get full subscriber info by IDmanychat_find_subscriber— Search subscribers by namemanychat_find_by_field— Search subscribers by custom field value
Sending (1 tool)
manychat_send_flow— Trigger a flow for a subscriber
Installation
npm install
npm run buildConfiguration
Add to your MCP client config (e.g., Claude Code .mcp.json):
{
"mcpServers": {
"manychat": {
"command": "node",
"args": ["/path/to/manychat-mcp/dist/index.js"],
"env": {
"MANYCHAT_API_TOKEN": "your_manychat_api_token"
}
}
}
}Getting Your ManyChat API Token
Log into ManyChat: https://manychat.com
Go to Settings → API
Generate a new API token
Copy the token (format:
PAGE_ID:TOKEN_STRING)
Permissions required:
Read access: Page info, flows, tags, custom fields, subscribers
Write access: Create tags, create fields, tag subscribers, send flows
Usage Examples
Check Account Info
manychat_page_info()Create Tags for Segmentation
manychat_create_tag(name: "quiz_completed")
manychat_create_tag(name: "purchased")Create Custom Fields
manychat_create_custom_field(
name: "wellnessGoal",
type: "text",
description: "Primary wellness goal from quiz"
)Find and Tag a Subscriber
# Find subscriber
manychat_find_subscriber(name: "John Doe")
# Add tag
manychat_tag_subscriber(
subscriber_id: "1234567890",
tag_name: "quiz_completed"
)Trigger a Flow
# First get flow ID
manychat_list_flows()
# Then trigger it
manychat_send_flow(
subscriber_id: "1234567890",
flow_ns: "content20250101000000_123456"
)API Rate Limits
ManyChat API allows 10 requests per second. This server automatically:
Retries on 429 (rate limit) errors
Uses exponential backoff
Maximum 3 retry attempts
Development
# Install dependencies
npm install
# Run in development mode with auto-reload
npm run dev
# Build for production
npm run build
# Clean build artifacts
npm run cleanProject Structure
manychat-mcp/
├── src/
│ ├── index.ts # Server entry point
│ ├── client.ts # ManyChat API client
│ └── tools/
│ ├── page.ts # Page info, flows, growth tools
│ ├── tags.ts # Tag management
│ ├── fields.ts # Custom field management
│ ├── subscribers.ts # Subscriber search
│ └── sending.ts # Flow triggering
├── dist/ # Compiled JavaScript
├── package.json
└── tsconfig.jsonError Handling
The server provides clear, actionable error messages:
401 Unauthorized → Check your API token
403 Forbidden → Token lacks required scope
404 Not Found → Resource doesn't exist
429 Rate Limit → Auto-retries with backoff
400 Bad Request → Invalid parameters (check Zod validation errors)
Tech Stack
TypeScript — Type-safe implementation
MCP SDK — Official Model Context Protocol SDK
Zod — Runtime schema validation
Native fetch — HTTP client (Node 18+)
Requirements
Node.js 18+
ManyChat PRO account (required for API access)
Valid ManyChat API token
Use Cases
Automation: Bulk tag/field management via LLM
DM Ecosystems: Build conversational flows with AI assistance
Analytics: Query subscriber data and engagement
Customer Support: Find and manage subscribers programmatically
Integration: Connect ManyChat with other tools via Claude
ManyChat API Documentation
For full API reference: https://manychat.com/api-docs
License
MIT
Contributing
Issues and pull requests welcome! This is a community-maintained MCP server.
Acknowledgments
Built with the Model Context Protocol by Anthropic.
Note: This is an unofficial ManyChat integration. Not affiliated with or endorsed by ManyChat.
Available Tools
17 toolsmanychat_create_custom_fieldCreate Custom FieldB
Create a new custom field in the ManyChat account. Types: text, number, date, datetime, boolean.
Inputs: name (required), type (required), description.
manychat_create_tagCreate TagA
Create a new tag in the ManyChat account. Returns the created tag with its ID.
Inputs: name (required).
manychat_find_by_fieldFind Subscriber by Custom FieldARead-only
Search for subscribers by a custom field value. Returns matching subscribers.
Inputs: field_name (required), field_value (required).
manychat_find_subscriberFind Subscriber by NameBRead-only
Search for subscribers by name. Returns matching subscribers with their IDs.
Inputs: name (required).
manychat_get_subscriberGet SubscriberARead-only
Get full subscriber info by ID, including tags, custom fields, and channel data
Inputs: subscriber_id (required).
manychat_list_custom_fieldsList Custom FieldsARead-only
List all custom fields in the ManyChat account with their IDs, names, and types
Inputs: no named parameters.
manychat_list_flowsList FlowsARead-only
List all automation flows in the ManyChat account with their IDs, names, and statuses
Inputs: no named parameters.
manychat_list_growth_toolsList Growth ToolsARead-only
List all growth tools (widgets, comment triggers, ads JSON) in the ManyChat account
Inputs: no named parameters.
manychat_list_tagsList TagsARead-only
List all tags in the ManyChat account with their IDs and names
Inputs: no named parameters.
manychat_page_infoPage InfoARead-only
Get ManyChat account/page info including name, status, and connected channels
Inputs: no named parameters.
manychat_send_contentSend ContentA
Send rich messages to a subscriber with full control: text, images, videos, audio, files, gallery cards, buttons (URL, call, flow), quick replies, actions (tag, set field), and external callbacks. Supports Instagram, WhatsApp, and Messenger channels. Max 10 messages per call. Note: Instagram/WhatsApp have a 24h messaging window - subscriber must have interacted recently.
Inputs: channel (required), messages (required), subscriber_id (required), actions, +3 more.
manychat_send_flowSend FlowA
Trigger a specific flow for a subscriber. Use manychat_list_flows to get flow IDs first.
Inputs: flow_ns (required), subscriber_id (required).
manychat_send_sequenceSend Message SequenceA
Send a multi-step message sequence to a subscriber, simulating a workflow. Each step can have its own messages, actions (tags, fields), quick replies, and an optional delay. Steps are sent in order. Use this to create automated conversation flows programmatically.
Inputs: steps (required), channel (required), subscriber_id (required), message_tag.
manychat_send_textSend Text MessageA
Quick shortcut to send a text message to a subscriber. Optionally include buttons, quick replies, and auto-tag. For more complex messages use manychat_send_content.
Inputs: text (required), channel (required), subscriber_id (required), buttons, +3 more.
manychat_set_fieldSet Custom FieldA
Set a custom field value for a subscriber by field name. The field must already exist.
Inputs: field_name (required), field_value (required), subscriber_id (required).
manychat_tag_subscriberTag SubscriberA
Add a tag to a subscriber by tag name. The tag must already exist.
Inputs: tag_name (required), subscriber_id (required).
manychat_untag_subscriberUntag SubscriberB
Remove a tag from a subscriber by tag name
Inputs: tag_name (required), subscriber_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools target a distinct resource/action pair, and the list_* tools clearly separate tags, fields, flows, and growth tools. The send_* family has some overlap, but send_text, send_content, send_sequence, and send_flow are differentiated by message complexity and workflow type.
Tool names mostly follow a consistent manychat_verb_noun pattern, such as list_tags, create_tag, get_subscriber, and send_flow. Minor deviations like manychat_page_info and manychat_find_by_field break the strict pattern but do not cause confusion.
With 17 tools, this sits at the high/borderline end of a reasonable tool count. The four send_* variants add some redundancy, but the overall number is understandable for a platform integration covering subscribers, tags, fields, flows, and messaging.
Core workflows around subscriber lookup, tagging, custom fields, and sending messages are covered, but there are notable gaps: no update/delete for tags or custom fields, no flow/growth-tool management beyond listing, and no way to enumerate all subscribers. Agents can complete common operational tasks but may hit dead ends for lifecycle management.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Klaviyo MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Mailchimp MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Meta Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for ManyContacts WhatsApp Business CRM that enables AI agents to manage contacts, send messages, run campaigns, and configure auto-replies through comprehensive CRM operations.5585 npmMIT
- FlicenseNot gradedqualityDmaintenanceA lightweight MCP server that connects Claude AI to Mautic marketing automation, enabling contact management, email sending, campaign operations, and analytics via natural language.1-
- AlicenseAqualityDmaintenanceMCP server to manage Meta Ads (Facebook/Instagram) campaigns, ad sets, insights, and audiences from Claude Code using natural language.98 npmMIT
- AlicenseAqualityDmaintenanceMCP Server for the Meta Marketing API. Gives Claude Desktop direct access to your ad account data — campaign performance, creative analysis, audience breakdowns, and budget pacing.10280 npm1MIT