n8n Workflow Builder MCP Server

by makafeli

Recommended

158 stars

23 downloads

Not rated

GitHub

About

A server for programmatically creating and managing n8n workflows with a REST API interface, supporting workflow creation, validation, and export.

Details

Author: makafeli
Repository: makafeli/n8n-workflow-builder
GitHub stars: 158
Downloads: 23
License: MIT License
Categories: Developer Tools, Productivity, Other, AI

- 🔧 Complete Workflow Management - Full CRUD operations for n8n workflows
- 🤖 AI-First Design - Built specifically for AI assistant integration
- 🚀 Zero Configuration - Works out of the box with NPX
- 🔒 Secure - Uses n8n's official API with proper authentication
- 📦 Modern Architecture - Built with TypeScript and latest MCP SDK
- ⚡ High Performance - Optimized for fast response times

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

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.) npx
Arguments
- Argument 1 @makafeli/n8n-workflow-builder
Environment
- N8N_HOST http://localhost:5678
- N8N_API_KEY your-api-key-here
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": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "/c",
                "npx",
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

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": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "/c",
                "npx",
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

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": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "/c",
                "npx",
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

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": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "/c",
                "npx",
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

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": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "/c",
                "npx",
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

From the repository

For development or customization:


npm install
Configure the following environment variables to connect to your n8n instance:
| Variable | Description | Example |

|----------|-------------|---------|

| N8N_HOST | Your n8n instance URL | http://localhost:5678 or https://your-n8n.com/api/v1 |

| N8N_API_KEY | Your n8n API key | n8n_api_1234567890abcdef... |
1. Open your n8n instance

2. Go to Settings → API Keys

3. Click Create API Key

4. Copy the generated key

bash

1. Check the GitHub Issues
2. Review n8n's API documentation
3. Verify your MCP client configuration

Fastest setup:
1. Use Smithery.ai hosted version (no installation): smithery.ai
2. Or run locally: npx @makafeli/n8n-workflow-builder
3. Configure your AI assistant with your n8n credentials
4. Start with simple commands like "list my workflows" or "show me workflow details"

📖 Detailed Guide: See our Getting Started Guide for step-by-step setup instructions.

`list_workflows`

List all workflows from your n8n instance. Parameters: None

`get_workflow`

Retrieve detailed information about a specific workflow. Parameters: `id`: Workflow ID (string)

`create_workflow`

Create a new workflow with nodes and connections. Parameters: `workflow`: Workflow object

`execute_workflow`

Manually execute a workflow. Parameters: `id`: Workflow ID (string)

`update_workflow`

Update an existing workflow's configuration. Parameters: `id`: Workflow ID, `workflow`: Updated workflow object

`activate_workflow`

Activate a workflow to enable automatic execution. Parameters: `id`: Workflow ID (string)

`deactivate_workflow`

Deactivate a workflow to stop automatic execution. Parameters: `id`: Workflow ID (string)

`delete_workflow`

Permanently delete a workflow. Parameters: `id`: Workflow ID (string)

`create_workflow_and_activate`

Create a new workflow and immediately activate it. Parameters: `workflow`: Workflow object

`list_executions`

List workflow executions with filtering and pagination. Parameters: `includeData`, `status`, `workflowId`, `projectId`, `limit`, `cursor`

`get_execution`

Get detailed information about a specific execution. Parameters: `id`: Execution ID, `includeData`: Include detailed data

`delete_execution`

Delete a workflow execution record. Parameters: `id`: Execution ID

`list_tags`

List all workflow tags with pagination. Parameters: `limit`, `cursor`

`create_tag`

Create a new workflow tag for organization. Parameters: `name`: Tag name

`generate_audit`

Generate comprehensive security audit report. Parameters: `additionalOptions`: Audit configuration

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "n8n workflow builder mcp server": {
            "env": {
                "N8N_HOST": "http://localhost:5678",
                "N8N_API_KEY": "your-api-key-here"
            },
            "args": [
                "@makafeli/n8n-workflow-builder"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
    },
    "args": [
        "@makafeli/n8n-workflow-builder"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
    },
    "args": [
        "@makafeli/n8n-workflow-builder"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
    },
    "args": [
        "/c",
        "npx",
        "@makafeli/n8n-workflow-builder"
    ],
    "command": "cmd"
}

n8n Workflow Builder MCP Server

<meta property="og:title" content="n8n Workflow Builder MCP Server - AI Assistant Integration for n8n Automation">
<meta property="og:description" content="Connect Claude Desktop, ChatGPT, and other AI assistants directly to your n8n instance for seamless workflow management, creation, and execution through natural language commands.">
<meta property="og:image" content="https://raw.githubusercontent.com/makafeli/n8n-workflow-builder/main/.github/assets/social-preview.png">
<meta property="og:url" content="https://github.com/makafeli/n8n-workflow-builder">
<meta property="og:type" content="website">
<meta property="twitter:card" content="summary_large_image">
<meta property="twitter:title" content="n8n Workflow Builder MCP Server - AI Assistant Integration">
<meta property="twitter:description" content="Connect AI assistants like Claude Desktop to n8n for natural language workflow automation. Create, manage, and execute workflows through conversation.">
<meta property="twitter:image" content="https://raw.githubusercontent.com/makafeli/n8n-workflow-builder/main/.github/assets/social-preview.png">

The ultimate AI assistant integration for n8n workflow automation - Connect Claude Desktop, ChatGPT, and other AI assistants directly to your n8n instance for seamless workflow management, creation, and execution through the Model Context Protocol (MCP).

<a href="https://www.npmjs.com/package/@makafeli/n8n-workflow-builder">

</a>
<a href="https://www.npmjs.com/package/@makafeli/n8n-workflow-builder">

</a>
<a href="https://github.com/makafeli/n8n-workflow-builder">

</a>
<a href="https://github.com/makafeli/n8n-workflow-builder/network/members">

</a>

<br>

<a href="https://github.com/makafeli/n8n-workflow-builder/actions">

</a>
<a href="https://github.com/makafeli/n8n-workflow-builder/blob/main/LICENSE">
License
</a>
<a href="https://nodejs.org/">

</a>
<a href="https://www.typescriptlang.org/">

</a>

<br>

<a href="https://glama.ai/mcp/servers/fhoynrlnpp">

</a>
 
<a href="https://mseep.ai/app/makafeli-n8n-workflow-builder">

</a>

</div>

A powerful Model Context Protocol (MCP) server that enables AI assistants to manage n8n workflows seamlessly. Connect your AI tools directly to n8n for automated workflow creation, execution, and management.

📚 Table of Contents

- What is this?
- Key Features
- Requirements
- Installation & Usage
- Configuration
- MCP Client Setup
- Available Tools
- Usage Examples
- Troubleshooting
- FAQ
- Contributing
- License
- Useful Links

📖 Additional Documentation

- 🚀 Getting Started Guide - Quick setup in under 5 minutes
- 💼 Real-World Use Cases - E-commerce, data processing, API integrations, and more
- 🔍 Comparison with Alternatives - vs Zapier, Make.com, n8n Web UI, and CLI
- 🔧 Comprehensive Troubleshooting - Solutions for common issues and problems

🎯 What is this?

The n8n Workflow Builder MCP Server bridges the gap between AI assistants (like Claude Desktop, Cline, or any MCP-compatible client) and your n8n automation platform. It provides a comprehensive set of tools that allow AI assistants to:

- List and browse your existing n8n workflows
- Create new workflows with complex node configurations
- Execute workflows on demand
- Manage workflow lifecycle (activate, deactivate, update, delete)
- Monitor workflow status and retrieve detailed information

Perfect for teams using n8n who want to leverage AI assistants for workflow automation and management.

✨ Key Features

📋 Requirements

- Node.js v18.0.0 or higher
- n8n instance (self-hosted or cloud)
- n8n API key with appropriate permissions

🚀 Installation & Usage

Method 1: Smithery.ai (Hosted - Recommended)

Use the hosted version on Smithery.ai - no installation required:

1. Visit: smithery.ai
2. Search: "n8n-workflow-builder"
3. Connect: Configure with your n8n host and API key
4. Use: Access from any MCP-compatible AI assistant

Benefits: No local setup, automatic updates, professional hosting, tool playground.

Method 2: NPX (Local)

Run locally with NPX:

npx @makafeli/n8n-workflow-builder

Method 2: Manual Installation

For development or customization:

```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

get_workflow

create_workflow

execute_workflow

update_workflow

activate_workflow

deactivate_workflow

delete_workflow

create_workflow_and_activate

list_executions

get_execution

delete_execution

list_tags

create_tag

generate_audit

Claude Desktop / Cursor

Linux

Macos

Windows

n8n Workflow Builder MCP Server

📚 Table of Contents

📖 Additional Documentation

🎯 What is this?

✨ Key Features

📋 Requirements

🚀 Installation & Usage

Method 1: Smithery.ai (Hosted - Recommended)

Method 2: NPX (Local)

Method 2: Manual Installation

Install

More like this

Sequential Thinking

Time

Sentry

Github

Filesystem

EverArt

`list_workflows`

`get_workflow`

`create_workflow`

`execute_workflow`

`update_workflow`

`activate_workflow`

`deactivate_workflow`

`delete_workflow`

`create_workflow_and_activate`

`list_executions`

`get_execution`

`delete_execution`

`list_tags`

`create_tag`

`generate_audit`