flipfactory-mcp-n8n
v1.0.0
Published
MCP n8n Builder — Create, validate, and cost-estimate n8n workflows with AI
Maintainers
Readme
MCP n8n Builder
Create, validate, and cost-estimate n8n workflows with AI. One MCP server, three powerful tools.
Quick Start
npm install @flipfactory/mcp-n8nAdd to your Claude Desktop config:
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["@flipfactory/mcp-n8n"]
}
}
}Optionally connect to a live n8n instance:
{
"mcpServers": {
"n8n": {
"command": "npx",
"args": ["@flipfactory/mcp-n8n"],
"env": {
"N8N_BASE_URL": "https://n8n.example.com",
"N8N_API_KEY": "your-api-key"
}
}
}
}Tools
| Tool | Description |
|------|-------------|
| n8n_create | Generate a valid n8n workflow JSON from a natural-language description |
| n8n_validate | Validate an n8n workflow JSON for errors, warnings, and best practices |
| n8n_estimate_cost | Estimate the monthly running cost of an n8n workflow |
Node Templates
The n8n_create tool includes built-in templates for common nodes:
| Template | n8n Node Type |
|----------|--------------|
| scheduleTrigger | Schedule Trigger (cron) |
| webhookTrigger | Webhook |
| manualTrigger | Manual Trigger |
| httpRequest | HTTP Request |
| set | Set Data |
| code | Code (JavaScript) |
| if | IF (condition) |
| switch | Switch |
| claude | Claude API (via HTTP Request) |
| openai | OpenAI API (via HTTP Request) |
| respondToWebhook | Respond to Webhook |
| sendEmail | Send Email |
| telegram | Telegram |
| postgres | PostgreSQL |
| errorTrigger | Error Trigger |
Configuration
| Variable | Required | Description |
|----------|----------|-------------|
| N8N_BASE_URL | No | n8n instance URL (for future deploy features) |
| N8N_API_KEY | No | n8n API key (for future deploy features) |
Examples
Create a workflow
"Build a workflow that runs daily, calls Claude API, and sends results to Telegram"
-> n8n_create(description: "Schedule trigger daily, call Claude API, send to Telegram")Create with specific nodes
"Create a webhook workflow with data transformation"
-> n8n_create(description: "Webhook API", nodes: ["webhookTrigger", "httpRequest", "set", "respondToWebhook"])Validate a workflow
"Check if this workflow JSON is valid"
-> n8n_validate(workflow: '{"name":"My Workflow","nodes":[...],...}')Estimate cost
"How much will this workflow cost to run?"
-> n8n_estimate_cost(workflow: '...', executionsPerDay: 10, avgItemsPerExecution: 5)Development
npm install
npm run dev # Watch mode
npm test # Run tests
npm run build # Compile TypeScriptPricing
$9/mo on Smithery
License
MIT — FlipFactory
