n8n Workflow Builder MCP Server

by salacoste

229 stars

839 downloads

Not rated

GitHub Website

About

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

Details

Author: salacoste
GitHub stars: 229
Downloads: 839
Categories: Productivity, Other, Automation, API

- AI-powered workflow creation from natural language descriptions
- Multi-instance management (dev, staging, production) from one server
- 17 comprehensive tools covering workflows, executions, tags, and credentials
- Natural language interface – no JSON editing required
- Secure by design with API key encryption and credential protection
- 38+ documentation pages with guides, tutorials, and API reference

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name n8n Workflow Builder MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

From the repository

Install globally via npm (npm install -g @kernel.salacoste/n8n-workflow-builder). Configure with a .config.json (multi‑instance) or a .env file (single instance). Add the server to your Claude Desktop configuration (claude_desktop_config.json) or Cursor IDE configuration (.cursor/mcp.json). Restart the client and describe workflows in plain English.

`list_workflows`

List all workflows from n8n with essential metadata only (ID, name, status, dates, node count, tags). Supports filtering by active status. Optimized for performance to prevent large data transfers.

`execute_workflow`

Manually execute a workflow by ID

`create_workflow`

Create a new workflow in n8n

`get_workflow`

Get a workflow by ID

`update_workflow`

Update an existing workflow

`patch_workflow`

Partially update workflow (returns guidance - PATCH not supported by n8n API). Use update_workflow for actual updates.

`delete_workflow`

Delete a workflow by ID

`activate_workflow`

Activate a workflow by ID

`deactivate_workflow`

Deactivate a workflow by ID

`list_executions`

List all executions from n8n with optional filters

`get_execution`

Get details of a specific execution by ID

`delete_execution`

Delete an execution by ID

`retry_execution`

Retry a failed workflow execution (creates new execution). Only works for executions with status "error".

`create_tag`

Create a new tag

`get_tags`

Get all tags

`get_tag`

Get a tag by ID

`update_tag`

Update a tag

`delete_tag`

Delete a tag

`list_credentials`

List all credentials (metadata only, sensitive data excluded for security). Returns credential ID, name, type, nodes access information, and timestamps. Actual credential data (passwords, tokens, keys) is never returned.

`get_credential`

Get credential by ID (returns guidance - GET not supported by n8n API for security). Credentials contain sensitive data and cannot be read through REST API.

`update_credential`

Update credential (returns guidance - PUT not supported by n8n API for security). Use delete + create pattern instead.

`create_credential`

Create a new credential for external service authentication. Supports multiple credential types (httpBasicAuth, httpHeaderAuth, OAuth2, etc.). Use get_credential_schema to understand required fields for each type. Sensitive data is automatically encrypted by n8n.

`delete_credential`

Delete a credential by ID. Removes the credential from n8n permanently. Workflows using this credential will need to be updated.

`get_credential_schema`

Get JSON schema for a specific credential type (e.g., httpBasicAuth, googleDriveOAuth2Api). Returns field definitions, types, required fields, and validation rules to help create credentials programmatically.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "mcp-n8n-workflow-builder": {
                "command": "npx",
                "args": [
                    "@kernel.salacoste/n8n-workflow-builder",
                    "--version"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-n8n-workflow-builder": {
        "command": "npx",
        "args": [
            "@kernel.salacoste/n8n-workflow-builder",
            "--version"
        ]
    }
}

n8n Workflow Builder MCP Server

AI-Powered Workflow Automation Through Natural Language

Build, manage, and monitor n8n workflows using Claude AI and Cursor IDE via the Model Context Protocol

Features • Quick Start • Documentation • Examples • API Reference

AI-Powered Workflow Builder - Build n8n workflows with natural language

</div>

---

🎯 What is This?

n8n Workflow Builder MCP Server transforms workflow automation by enabling you to create and manage n8n workflows through conversational AI. No more manual JSON editing or complex UI navigation—just describe what you need in natural language, and let AI build it for you.

The Problem It Solves

- ❌ Manual workflow building is time-consuming and error-prone
- ❌ Complex JSON editing requires deep technical knowledge
- ❌ Switching between IDE and n8n UI breaks your development flow
- ❌ Managing multiple n8n environments (dev, staging, prod) is tedious

The Solution

- ✅ Build workflows conversationally using Claude AI or Cursor IDE
- ✅ Natural language interface - describe workflows in plain English
- ✅ Multi-instance support - manage dev, staging, and production from one place
- ✅ 17 powerful tools - complete workflow lifecycle management
- ✅ Stay in your IDE - no context switching required

---

✨ Key Features

🤖 AI-Powered Workflow Creation

Create complex n8n workflows by simply describing what you need. Claude AI and Cursor IDE understand your intent and generate production-ready workflows.

🌍 Multi-Instance Management

Seamlessly manage multiple n8n environments (production, staging, development) from a single MCP server with intelligent instance routing.

🛠️ 17 Comprehensive Tools

Complete workflow lifecycle coverage: - 8 Workflow Tools - Create, update, delete, activate, execute - 4 Execution Tools - Monitor, retry, analyze runs - 5 Tag Tools - Organize and categorize workflows - 6 Credential Tools (Epic 2) - Secure credential management

</td>
<td width="50%">

💬 Natural Language Interface

No JSON editing required. Build workflows like this:

> "Create a webhook workflow that validates customer emails, sends a Slack notification, and stores data in PostgreSQL"

🔒 Secure by Design

- Built-in credential protection - API key encryption - Secure multi-instance configuration - Never exposes sensitive data in logs

📚 Comprehensive Documentation

- 38+ documentation pages with guides and tutorials - Interactive examples and workflow patterns - Troubleshooting guides and FAQs - API reference with complete tool documentation

</td>
</tr>
</table>

---

🚀 Quick Start

Prerequisites

- Node.js v14+ (v18+ recommended)
- npm v7+
- n8n instance with API access (tested with n8n v1.82.3+)
- Claude Desktop or Cursor IDE

Installation

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_workflows

execute_workflow

create_workflow

get_workflow

update_workflow

patch_workflow

delete_workflow

activate_workflow

deactivate_workflow

list_executions

get_execution

delete_execution

retry_execution

create_tag

get_tags

get_tag

update_tag

delete_tag

list_credentials

get_credential

update_credential

create_credential

delete_credential

get_credential_schema

Claude Desktop / Cursor

McpServers

n8n Workflow Builder MCP Server

AI-Powered Workflow Automation Through Natural Language

🎯 What is This?

The Problem It Solves

The Solution

✨ Key Features

🤖 AI-Powered Workflow Creation

🌍 Multi-Instance Management

🛠️ 17 Comprehensive Tools

💬 Natural Language Interface

🔒 Secure by Design

📚 Comprehensive Documentation

🚀 Quick Start

Prerequisites

Installation

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Time

Filesystem

`list_workflows`

`execute_workflow`

`create_workflow`

`get_workflow`

`update_workflow`

`patch_workflow`

`delete_workflow`

`activate_workflow`

`deactivate_workflow`

`list_executions`

`get_execution`

`delete_execution`

`retry_execution`

`create_tag`

`get_tags`

`get_tag`

`update_tag`

`delete_tag`

`list_credentials`

`get_credential`

`update_credential`

`create_credential`

`delete_credential`

`get_credential_schema`