home / mcp / n8n workflow builder mcp server

n8n Workflow Builder MCP Server

AI assistant integration for n8n workflow automation through Model Context Protocol (MCP). Connect Claude Desktop, ChatGPT, and other AI assistants to n8n for natural language workflow management.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "danilonovaisv-n8n-workflow-builder-gpt": {
      "command": "npx",
      "args": [
        "@makafeli/n8n-workflow-builder"
      ],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

The n8n Workflow Builder MCP Server lets AI assistants manage your n8n workflows through natural language. It acts as a bridge between MCP-enabled chat agents and your n8n instance, enabling you to list, create, run, and modify workflows with ease from conversational interfaces.

How to use

To use this MCP server, connect an MCP-compatible AI assistant (such as Claude Desktop or Cline) to your n8n instance using the configured MCP client settings. Once connected, you can ask your assistant to review existing workflows, create new ones with node configurations, execute workflows on demand, and manage their lifecycle by activating, updating, or deleting them. The integration also supports monitoring execution status and accessing detailed results.

Typical usage patterns include: listing all workflows, inspecting a specific workflow’s details, creating a new workflow with a specified structure, triggering a workflow execution, and toggling a workflow’s active state. You can also request actions like updating a workflow’s configuration, or generating an audit or report related to your workflow environment.

How to install

Prerequisites you need before installing is Node.js version 18.0.0 or higher and access to your n8n instance with a valid API key.

Option 1: NPX (quick start, local run)

npx @makafeli/n8n-workflow-builder

Option 2: Manual installation (development or customization)

# Clone the repository
git clone https://github.com/makafeli/n8n-workflow-builder.git
cd n8n-workflow-builder

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Additional setup details

If you prefer hosting, you can also deploy the server to a hosting environment that supports Node.js. Ensure you provide the required environment variables to connect to your n8n instance.

Available tools

list_workflows

List all workflows from your n8n instance

get_workflow

Retrieve detailed information about a specific workflow using its ID

create_workflow

Create a new workflow with nodes and connections from a workflow object

execute_workflow

Manually execute a workflow by its ID

update_workflow

Update an existing workflow's configuration by ID and a new workflow object

activate_workflow

Activate a workflow to enable automatic execution by ID

deactivate_workflow

Deactivate a workflow to stop automatic execution by ID

delete_workflow

Permanently delete a workflow by ID

create_workflow_and_activate

Create a new workflow and immediately activate it

list_executions

List workflow executions with filtering, pagination, and status

get_execution

Get detailed information about a specific execution by ID

delete_execution

Delete a workflow execution record by ID

list_tags

List all workflow tags with pagination

create_tag

Create a new workflow tag for organization

generate_audit

Generate a comprehensive security audit report