FlowEngine Model Context Protocol server for Claude. Manage n8n workflows, build UI components, configure client portals, and provision instances directly from Claude Desktop, VSCode, or CLI. Built with modern MCP Apps API.
npm install flowengine-mcp-appControl your white-label automation platform directly from Claude
The official Model Context Protocol (MCP) server for FlowEngine. Manage instances, client portals, and build UI components using AI - all from Claude Desktop, VSCode, or Claude Code CLI.
FlowEngine is a white-label n8n automation platform that lets you build and deploy workflow automations for your clients. This MCP server brings FlowEngine's core capabilities into Claude for seamless management.
1. Log in to FlowEngine
2. Go to Settings ā API Access
3. Click "Generate API Key"
4. Copy your key (shown only once)
#### Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
``json`
{
"mcpServers": {
"flowengine": {
"command": "npx",
"args": ["-y", "flowengine-mcp-app"],
"env": {
"FLOWENGINE_API_KEY": "your-api-key-here"
}
}
}
}
#### Claude Code CLI
Edit ~/.claude/claude_code_config.json:
`json`
{
"mcpServers": {
"flowengine": {
"command": "npx",
"args": ["-y", "flowengine-mcp-app"],
"env": {
"FLOWENGINE_API_KEY": "your-api-key-here"
}
}
}
}
#### VSCode (Claude Extension)
Add to your VSCode settings:
`json`
{
"mcp.servers": {
"flowengine": {
"command": "npx",
"args": ["-y", "flowengine-mcp-app"],
"env": {
"FLOWENGINE_API_KEY": "your-api-key-here"
}
}
}
}
Then restart Claude Desktop, start a new Claude Code session, or reload VSCode.
NEW! Visual dashboards with interactive HTML interfaces. Ask Claude:
| Command | What You Get |
|---------|--------------|
| "Show me the FlowEngine client portals dashboard" | Interactive dashboard with all your client portals, URLs, and storage details |
| "Show me the AI FlowBuilder" | Visual dashboard for managing forms, chatbots, and widgets across all instances |
| "Show me my FlowEngine instances" | Instance manager dashboard with resource details and quick actions |
How it works:
1. Ask Claude using the exact commands above
2. Claude will display a rich HTML dashboard
3. View all your data in a visual, organized format
Fallback: If dashboards don't appear, use text-based tools:
``
"Use flowengine_list_portals to show my portals"
"Use flowengine_list_instances"
"Use flowengine_list_components"
Manage your platform through conversation:
``
"List all my FlowEngine instances"
"What's the status of instance abc123?"
"Create a new contact form widget"
"Show me all UI components"
"Provision a new instance for Acme Corp"
- List all instances
- flowengine_get_instance_status - Get instance health
- flowengine_create_instance - Provision new instance
- flowengine_update_instance - Update settings
- flowengine_delete_instance - Delete instance$3
- flowengine_list_portals - List all portals$3
- flowengine_list_components - List UI components
- flowengine_get_component - Get component details
- flowengine_create_component - Create form/chatbot/widget
- flowengine_update_component - Update component
- flowengine_delete_component - Delete componentTotal: 11 tools (optimized to prevent API concurrency issues)
Resources
Interactive UI dashboards available via MCP Apps (MCP v1.1+):
-
ui://flowengine/portals - Client Portals Dashboard
- ui://flowengine/ui-builder - AI FlowBuilder
- ui://flowengine/instances - Instance ManagerNote: MCP Apps is a new feature announced January 26, 2026. Support may vary by client:
- ā
Claude Desktop: Coming soon
- ā
Claude Code: Check version compatibility
- ā
VSCode: Depends on extension version
Configuration
$3
-
FLOWENGINE_API_KEY (required) - Your FlowEngine API key
- FLOWENGINE_BASE_URL (optional) - Custom base URL (defaults to https://flowengine.cloud)$3
For self-hosted or custom deployments:
`json
{
"env": {
"FLOWENGINE_API_KEY": "your-key",
"FLOWENGINE_BASE_URL": "https://your-domain.com"
}
}
`Development
$3
`bash
Clone and install
git clone https://github.com/FlowEngine-cloud/flowengine.git
cd flowengine/flowengine-mcp
npm installBuild
npm run buildTest locally
node build/index.js
`$3
`
flowengine-mcp/
āāā src/
ā āāā index.ts # MCP server
ā āāā client.ts # FlowEngine API client
ā āāā ui/ # Dashboard renderers
ā āāā base.ts
ā āāā portals.ts
ā āāā widgets.ts
ā āāā instances.ts
āāā package.json
āāā tsconfig.json
āāā README.md
`$3
Point your MCP config to local build:
`json
{
"mcpServers": {
"flowengine": {
"command": "node",
"args": ["/path/to/flowengine-mcp/build/index.js"],
"env": {
"FLOWENGINE_API_KEY": "your-key"
}
}
}
}
`Troubleshooting
$3
Error: "FlowEngine API key not configured"
Solution: Verify
FLOWENGINE_API_KEY is set in your MCP config$3
Error: "Failed to connect to FlowEngine API"
Solutions:
- Check your internet connection
- Verify API key is valid
- Ensure
FLOWENGINE_BASE_URL is correct (if using custom)$3
Server doesn't appear in Claude
Solutions:
- Restart Claude Desktop / reload VSCode / start new Claude Code session
- Check MCP config JSON syntax is valid
- View logs:
~/.claude/debug/latest` (Claude Code)- FlowEngine Support: flowengine.cloud/support
- Documentation: docs.flowengine.cloud
- GitHub Issues: github.com/FlowEngine-cloud/flowengine/issues
- MCP Protocol: modelcontextprotocol.io
MIT License - See LICENSE file for details
Contributions welcome! Please read our contributing guidelines before submitting PRs.
---
Built by the FlowEngine team