Skip to main content
Glama
MessengerFlow MCP Server

MessengerFlow MCP Server

MessengerFlow MCP Server

npm

MCP server for MessengerFlow — manage campaigns, accounts, leads, inbox, and analytics from AI assistants like Claude Desktop.

Requires an active subscription on the Momentum plan or above.

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "messengerflow": {
      "command": "npx",
      "args": ["@messengerflow/mcp-server"],
      "env": {
        "MESSENGERFLOW_API_KEY": "mf_your_key_here"
      }
    }
  }
}

Remote Server (OAuth)

No API key needed, authenticates with your MessengerFlow account. In Claude, add it as a custom connector using https://mcp.messengerflow.com/mcp, or in other clients:

{
  "mcpServers": {
    "messengerflow": {
      "url": "https://mcp.messengerflow.com/mcp"
    }
  }
}

Local Development

cd mcp
npm install
MESSENGERFLOW_API_KEY=mf_your_key npm run dev

Related MCP server: Meta Marketing API MCP Server

Configuration

Variable

Required

Default

Description

MESSENGERFLOW_API_KEY

Yes

—

API key (starts with mf_)

MESSENGERFLOW_BASE_URL

No

https://app.messengerflow.com/api/v1

API base URL

To get your API key:

  1. Log in to app.messengerflow.com

  2. Go to Settings > Developers

  3. On the API Keys tab, click Create Key and copy the key (starts with mf_)

An API key cannot change the login email or password, cancel or change the plan, create or revoke API keys, open the billing portal, or delete Facebook accounts. Those are done in the app.

Tools

Tool

Description

manage_campaigns

Create, update, start/stop, delete campaigns. View leads and activity.

manage_accounts

Add and update Facebook accounts. View stats, usage, logs and friends. Profile setup, warming and Live Session links.

manage_leads

Import CSV, scrape groups/pages, find and join groups, merge, export lead collections.

manage_inbox

View conversations, search, send messages, manage read status.

get_analytics

Dashboard stats, activity charts, performance metrics.

manage_proxies

Add, update, verify and delete your own proxies. Switch between managed and own proxies.

upload_media

Upload an image, video or voice file from a link for use in messages, campaigns and profile setup.

manage_settings

Plan and limits, invoices, notifications, saved replies, campaign drafts, webhooks and feedback.

Resources

URI

Description

messengerflow://dashboard

Dashboard stats

Examples

  • "List my campaigns"

  • "Show dashboard stats"

  • "How many unread messages do I have?"

  • "Create a new campaign called 'Spring Launch'"

  • "Export leads from collection X"

Build

npm run build   # Outputs to dist/
npm start       # Run built version

Source and contributions

This repository is a read-only mirror of the mcp/ directory of the MessengerFlow monorepo, updated automatically on every change. Issues and pull requests are welcome here; accepted changes are applied in the monorepo and mirrored back. Licensed under MIT.

Available Tools

5 tools
get_analyticsB

Get dashboard stats, activity charts, performance metrics, and message/booking charts.

Inputs: action (required), period.

manage_accountsC

Add, update, and delete Facebook accounts. View account stats and logs.

Inputs: action (required), id, data, limit, +1 more.

manage_campaignsC

Create, update, start, stop, and delete campaigns. View campaign leads and activity. Manage campaign account assignments.

Inputs: action (required), id, data, limit, +3 more.

manage_inboxA

View conversations, search messages, send replies, mark read/unread, and delete conversations.

Inputs: action (required), id, data, limit, +2 more.

manage_leadsB

Manage lead collections — import CSV, scrape groups/pages, merge, rename, delete, export. Browse individual leads within a collection.

Inputs: action (required), id, data, limit, +2 more.

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 5 tools

    Disambiguation4/5

    Each tool has a clearly distinct primary responsibility: campaigns, accounts, leads, inbox, and analytics. However, manage_campaigns includes viewing leads and activity, which overlaps somewhat with manage_leads and get_analytics, and manage_accounts includes stats and logs, which also touches analytics. This slight overlap may cause occasional ambiguity but is not severe.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: manage_* for operational tools and get_analytics for data retrieval. The prefix 'manage' uniformly covers CRUD-like operations across different resources, and 'get' clearly signals a read-only analytics function. This is highly predictable.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a messaging campaign platform. Each tool represents a major functional area (campaigns, accounts, leads, inbox, analytics) without fragmentation or bloat. This is within the ideal range for clarity and maintainability.

    Completeness5/5

    The tool set covers the core lifecycle needs for the domain: campaigns can be created, updated, started, stopped, and deleted; accounts are fully manageable; leads support import, merge, rename, delete, export, and browsing; inbox handles conversations comprehensively; analytics provides dashboard and performance data. No obvious missing operations are apparent for the intended purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Facebook and Instagram advertising via the Meta Marketing API. It provides comprehensive tools for campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
      202
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Facebook and Instagram advertising data through the Meta Marketing API. It supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to manage Facebook and Instagram advertising campaigns through the Meta Marketing API. Supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
      -
    • A
      license
      B
      quality
      F
      maintenance
      Connects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.
      100
      520 npm
      68
      MIT