MessengerFlow MCP Server
Manage MessengerFlow from AI assistants: campaigns, Facebook accounts, leads, inbox, analytics, proxies, media, and settings.
Create, update, start/stop, and delete campaigns; view campaign leads, activity, and account assignments.
Add, update, and delete Facebook accounts; view account stats and logs.
Import, scrape, merge, rename, delete, and export lead collections; browse leads.
View/search conversations, send replies, mark read/unread, delete conversations, and get unread counts.
Get dashboard stats, activity charts, performance metrics, and message/booking charts.
Manage proxies, upload media from links, and access plan/limits, invoices, notifications, saved replies, campaign drafts, webhooks, feedback, and dashboard stats.
Provides tools for managing Facebook accounts, campaigns, and lead collections, including the ability to scrape groups and pages for lead generation.
Enables interaction with messaging features, allowing users to view conversations, search through messages, and send messages directly.
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., "@MessengerFlow MCP Server Show my active campaigns and today's lead performance."
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.
MessengerFlow MCP Server
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 devRelated MCP server: Meta Marketing API MCP Server
Configuration
Variable | Required | Default | Description |
| Yes | — | API key (starts with |
| No |
| API base URL |
To get your API key:
Log in to app.messengerflow.com
Go to Settings > Developers
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 |
| Create, update, start/stop, delete campaigns. View leads and activity. |
| Add and update Facebook accounts. View stats, usage, logs and friends. Profile setup, warming and Live Session links. |
| Import CSV, scrape groups/pages, find and join groups, merge, export lead collections. |
| View conversations, search, send messages, manage read status. |
| Dashboard stats, activity charts, performance metrics. |
| Add, update, verify and delete your own proxies. Switch between managed and own proxies. |
| Upload an image, video or voice file from a link for use in messages, campaigns and profile setup. |
| Plan and limits, invoices, notifications, saved replies, campaign drafts, webhooks and feedback. |
Resources
URI | Description |
| 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 versionSource 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 toolsget_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
60+ Meta Ads tools for AI agents: audits, campaign management, audiences and CAPI tracking.
The simplest way to manage your Meta (Facebook and Instagram) ad accounts with your AI agent.
LinkedIn, WhatsApp, Telegram and Instagram inboxes, profiles and outreach for your AI assistant.
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- AlicenseNot gradedqualityDmaintenanceEnables 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
- -licenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- AlicenseBqualityFmaintenanceConnects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.100520 npm68MIT