Skip to main content
Glama
MCP-manychat

MCP-manychat

by vdloureiro

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 channels

  • manychat_list_flows — List all automation flows with IDs and names

  • manychat_list_growth_tools — List comment triggers, ad tools, widgets

Tags (4 tools)

  • manychat_list_tags — List all tags

  • manychat_create_tag — Create a new tag

  • manychat_tag_subscriber — Add tag to subscriber by name

  • manychat_untag_subscriber — Remove tag from subscriber by name

Custom Fields (3 tools)

  • manychat_list_custom_fields — List all custom fields

  • manychat_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 ID

  • manychat_find_subscriber — Search subscribers by name

  • manychat_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 build

Configuration

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

  1. Log into ManyChat: https://manychat.com

  2. Go to Settings → API

  3. Generate a new API token

  4. 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 clean

Project 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.json

Error 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 tools
manychat_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 FieldA
Read-only

Search for subscribers by a custom field value. Returns matching subscribers.

Inputs: field_name (required), field_value (required).

manychat_find_subscriberFind Subscriber by NameB
Read-only

Search for subscribers by name. Returns matching subscribers with their IDs.

Inputs: name (required).

manychat_get_subscriberGet SubscriberA
Read-only

Get full subscriber info by ID, including tags, custom fields, and channel data

Inputs: subscriber_id (required).

manychat_list_custom_fieldsList Custom FieldsA
Read-only

List all custom fields in the ManyChat account with their IDs, names, and types

Inputs: no named parameters.

manychat_list_flowsList FlowsA
Read-only

List all automation flows in the ManyChat account with their IDs, names, and statuses

Inputs: no named parameters.

manychat_list_growth_toolsList Growth ToolsA
Read-only

List all growth tools (widgets, comment triggers, ads JSON) in the ManyChat account

Inputs: no named parameters.

manychat_list_tagsList TagsA
Read-only

List all tags in the ManyChat account with their IDs and names

Inputs: no named parameters.

manychat_page_infoPage InfoA
Read-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

    A3.6/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP 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.
      55
      85 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A lightweight MCP server that connects Claude AI to Mautic marketing automation, enabling contact management, email sending, campaign operations, and analytics via natural language.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server to manage Meta Ads (Facebook/Instagram) campaigns, ad sets, insights, and audiences from Claude Code using natural language.
      9
      8 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      10
      280 npm
      1
      MIT