MessengerFlow MCP server
Commit Nov 14, 2026Manage MessengerFlow campaigns, accounts, leads, inbox, and analytics directly through AI assistants.
Also known as MessengerFlow/mcp
- Stars
- 1
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- MIT
What is MessengerFlow MCP?
MessengerFlow manages MessengerFlow campaigns, accounts, leads, inbox, and analytics directly through AI assistants. It exposes 5 tools, such as manage_campaigns, manage_accounts, manage_leads.
Summary generated from the project's README
About MessengerFlow MCP server
Managing MessengerFlow marketing operations from within an AI assistant like Claude Desktop allows users to handle complex workflows through natural language. Marketing professionals can control campaigns, monitor lead generation, and interact with their inbox without switching between different browser tabs. The server provides specific tools to manage Facebook accounts, scrape groups or pages for leads, and view performance metrics through analytics.
Setup depends on your preferred connection method. You can run it locally using an API key starting with mf_ via npx, which requires a Momentum plan subscription or higher. Alternatively, you can connect to a remote server using OAuth by adding the provided URL as a custom connector in your client. This setup enables direct interaction with tools like manage_campaigns, manage_leads, and manage_inbox to automate routine communication and data management tasks.
What you can do with it
- 1Campaign Lifecycle ManagementAsk your AI assistant to create, modify, or stop specific marketing campaigns.
- 2Lead Data ProcessingInstruct the assistant to import lead data from a CSV file or scrape new leads from social groups.
- 3Inbox and Communication ControlCheck for unread messages and send replies to customers directly through the chat interface.
- 4Performance MonitoringRequest dashboard statistics and activity charts to evaluate your current marketing performance.
Written from the project's README. Every use case is checked against a quote from it.
MessengerFlow MCP tools 5
Detected from the READMEmanage_campaignsmanage_accountsmanage_leadsmanage_inboxget_analytics
Configuration
MESSENGERFLOW_API_KEY
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemessengerflow/mcp is public and reachablegithub.com/messengerflow/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/messengerflow/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMessengerFlow 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 dev
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:
- Log in to app.messengerflow.com
- Go to Settings > API Keys
- Click Create API Key and copy the key (starts with
mf_)
Tools
| Tool | Description |
|---|---|
manage_campaigns |
Create, update, start/stop, delete campaigns. View leads and activity. |
manage_accounts |
Add, update, delete Facebook accounts. View stats and logs. |
manage_leads |
Import CSV, scrape groups/pages, merge, export lead collections. |
manage_inbox |
View conversations, search, send messages, manage read status. |
get_analytics |
Dashboard stats, activity charts, performance metrics. |
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.
MessengerFlow MCP questions
What tools does MessengerFlow MCP provide?
It exposes 5 tools, including manage_campaigns, manage_accounts, manage_leads, manage_inbox, get_analytics.
What subscription plan is required?
You need an active subscription on the Momentum plan or higher to use this server.
Can I use this without an API key?
Yes, you can use the remote server via OAuth by adding it as a custom connector using the provided URL.