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:

1. Log in to app.messengerflow.com
2. Go to Settings > API Keys
3. 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