README.md
Manage campaigns, accounts, leads, inbox, and analytics from AI assistants.
MessengerFlow MCP Server
MCP server for MessengerFlow — manage campaigns, accounts, leads, inbox, and analytics from AI assistants like Claude Desktop.
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:
{
"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
Tools (5)
manage_campaignsCreate, update, start/stop, or delete marketing campaigns and view associated leads and activity.manage_accountsAdd, update, or delete Facebook accounts and view their statistics and logs.manage_leadsImport CSV files, scrape groups or pages, and merge or export lead collections.manage_inboxView conversations, search messages, send replies, and manage read status.get_analyticsRetrieve dashboard statistics, activity charts, and performance metrics.Environment Variables
MESSENGERFLOW_API_KEYrequiredAPI key for authentication, starts with mf_MESSENGERFLOW_BASE_URLAPI base URL, defaults to https://app.messengerflow.com/api/v1Configuration
claude_desktop_config.json
{"mcpServers": {"messengerflow": {"command": "npx", "args": ["@messengerflow/mcp-server"], "env": {"MESSENGERFLOW_API_KEY": "mf_your_key_here"}}}}Try it
→List my active marketing campaigns.
→Show me the performance dashboard stats for this week.
→How many unread messages do I have in my inbox?
→Create a new campaign called 'Spring Launch'.
→Export the leads from my latest collection to a CSV.