mcp-n8n-workflow-builder

🥈Silver

AI-powered n8n workflow automation through natural language. MCP server enabling Claude AI & Cursor IDE to create, manage, and monitor workflows via Model Context Protocol. Multi-instance support, 17 tools, comprehensive docs. Build workflows conversationally without manual JSON editing.

220580Updated 2w ago

Intermediate30min to implementautomation

Saves ~150 min per use

Quick InstallView Source

git clone https://github.com/salacoste/mcp-n8n-workflow-builder.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Define your automation goal. Open your n8n instance and identify the trigger (e.g., webhook, schedule, or app event) and the actions you want to automate (e.g., CRM updates, notifications, or data processing).","tip":"Use the n8n workflow builder interface to sketch a rough flow of nodes before asking the AI to generate the full workflow. This helps you clarify requirements."},{"step":"Use the AI skill to generate the workflow. Paste the prompt template into your AI assistant (e.g., Claude or Cursor IDE) with your specific requirements filled in. For example: 'Build an n8n workflow that syncs new Shopify orders to QuickBooks. Include a webhook trigger, format the order data for QuickBooks, and log errors to a Google Sheet.'","tip":"Include as many details as possible in the [PLACEHOLDERS] to get a more accurate and functional workflow. Mention specific tools, credentials, and edge cases (e.g., 'handle failed API calls by sending an email to admin@company.com')."},{"step":"Review and customize the generated workflow. The AI will output a JSON workflow file. Copy this into your n8n instance (via the workflow editor or CLI) and update any placeholder credentials or configurations.","tip":"Test the workflow in a development environment first. Use n8n's 'Execute Workflow' button to run test data through the flow and verify each node behaves as expected."},{"step":"Deploy and monitor. Once tested, activate the workflow in your production n8n instance. Monitor execution logs for errors and iterate based on real-world usage.","tip":"Set up logging for critical workflows. Use n8n's built-in logging or integrate with a tool like Datadog or Google Sheets to track errors and performance over time."},{"step":"Iterate and expand. As your needs evolve, use the AI skill to modify or extend the workflow. For example, add new triggers, actions, or error-handling steps without starting from scratch.","tip":"Keep a backup of your workflow JSON files. Use version control (e.g., Git) to track changes and roll back if needed."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/salacoste/mcp-n8n-workflow-builder

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Build an n8n workflow that [ACTION] for [TARGET]. Include [TRIGGER] and [ACTION_STEPS]. Use [SPECIFIC_TOOLS] if mentioned. Ensure the workflow handles [ERROR_HANDLING] and logs [LOGGING_REQUIREMENTS]. Test the workflow with [TEST_CASE].

Example Output

```json
{
  "name": "Lead Qualification & CRM Sync",
  "nodes": [
    {
      "parameters": {
        "trigger": "webhook",
        "path": "/new-lead",
        "method": "POST"
      },
      "id": "webhook-node",
      "name": "Webhook Trigger",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2.1,
      "position": [250, 300]
    },
    {
      "parameters": {
        "functionCode": "return items.map(item => {\n  const lead = item.json;
  return {\n    ...lead,\n    score: lead.email.includes('@company.com') ? 80 : 50,\n    tags: lead.email.includes('@company.com') ? ['enterprise'] : ['sme']\n  };\n});"
      },
      "id": "score-lead",
      "name": "Score Lead",
      "type": "n8n-nodes-base.function",
      "position": [450, 300]
    },
    {
      "parameters": {
        "conditions": {
          "string": [
            {
              "value1": "={{ $json.score }}",
              "operation": "larger",
              "value2": 70
            }
          ]
        }
      },
      "id": "route-lead",
      "name": "Route to Enterprise Team",
      "type": "n8n-nodes-base.if",
      "typeVersion": 1,
      "position": [650, 200]
    },
    {
      "parameters": {
        "resource": "contact",
        "operation": "create",
        "additionalFields": {}
      },
      "id": "hubspot-enterprise",
      "name": "Create HubSpot Contact (Enterprise)",
      "type": "n8n-nodes-base.hubspot",
      "typeVersion": 2,
      "position": [850, 100],
      "credentials": {
        "hubspotApi": "HubSpot API"
      }
    },
    {
      "parameters": {
        "resource": "contact",
        "operation": "create",
        "additionalFields": {}
      },
      "id": "hubspot-sme",
      "name": "Create HubSpot Contact (SME)",
      "type": "n8n-nodes-base.hubspot",
      "typeVersion": 2,
      "position": [850, 300],
      "credentials": {
        "hubspotApi": "HubSpot API"
      }
    },
    {
      "parameters": {
        "channel": "#leads-alerts",
        "text": "New lead scored: {{ $json.score }} - {{ $json.name }} ({{ $json.email }})",
        "attachments": []
      },
      "id": "slack-notify",
      "name": "Notify Slack Channel",
      "type": "n8n-nodes-base.slack",
      "typeVersion": 2,
      "position": [1050, 200],
      "credentials": {
        "slackApi": "Slack API"
      }
    }
  ],
  "connections": {
    "Webhook Trigger": {
      "main": [[{"node": "Score Lead", "type": "main", "index": 0}]]
    },
    "Score Lead": {
      "main": [[{"node": "Route to Enterprise Team", "type": "main", "index": 0}]]
    },
    "Route to Enterprise Team": {
      "main": [
        [{"node": "Create HubSpot Contact (Enterprise)", "type": "main", "index": 0}],
        [{"node": "Create HubSpot Contact (SME)", "type": "main", "index": 0}]
      ]
    },
    "Create HubSpot Contact (Enterprise)": {
      "main": [[{"node": "Notify Slack Channel", "type": "main", "index": 0}]]
    },
    "Create HubSpot Contact (SME)": {
      "main": [[{"node": "Notify Slack Channel", "type": "main", "index": 0}]]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "1.0.0"
}
```

### Workflow Explanation:
This workflow automates lead qualification and CRM synchronization for a SaaS company. When a new lead is submitted via webhook (e.g., from a landing page), the system:

1. **Scores the lead** based on domain (80 points for company emails, 50 for others) and assigns tags.
2. **Routes high-value leads** (score > 70) to the enterprise sales team and standard leads to the SME team.
3. **Creates contacts** in HubSpot for both routes, ensuring proper tagging and segmentation.
4. **Notifies the #leads-alerts Slack channel** with the lead score and details for real-time visibility.

### Testing the Workflow:
To test, send a POST request to the webhook URL (e.g., `https://your-n8n-instance.com/webhook/new-lead`) with a JSON payload like:
```json
{
  "name": "Jane Doe",
  "email": "jane@company.com",
  "company": "TechCorp",
  "phone": "+1234567890"
}
```

Verify that:
- The lead is scored correctly (80 for company.com emails).
- The contact is created in HubSpot with the appropriate tags.
- The Slack notification includes the correct score and details.

### Error Handling:
The workflow includes implicit error handling via n8n's built-in retry logic for API calls (HubSpot/Slack). For production use, consider adding:
- A **"Catch" node** to handle failed API calls and route them to a manual review queue.
- **Logging** in a database or logging service (e.g., n8n's built-in logging or a tool like Datadog).

### Next Steps:
1. **Deploy the workflow** in your n8n instance.
2. **Update credentials** for HubSpot and Slack APIs.
3. **Test with real data** and monitor execution logs for errors.
4. **Iterate** based on feedback from sales teams (e.g., adjust scoring thresholds or add more routing rules).