n8n Workflow Manager MCP Server

Developer ToolsJavaScript

Interact with n8n workflows through natural language

Available Tools

list_workflows

Lists all workflows in the n8n instance, with options to filter by tags or active status

get_workflow

Retrieves detailed information about a specific workflow by ID or name

create_workflow

Creates a new workflow from a JSON definition

update_workflow

Updates an existing workflow with new configuration

delete_workflow

Deletes a workflow by ID or name

activate_workflow

Activates a workflow by ID or name

deactivate_workflow

Deactivates a workflow by ID or name

execute_workflow

Executes a workflow with optional input data

get_execution

Retrieves information about a specific workflow execution

run_webhook

Executes a workflow via its webhook URL

The n8n Workflow Manager MCP provides a seamless interface for AI assistants to interact with n8n, a powerful workflow automation platform. It enables assistants to manage workflows, trigger executions, and monitor results through natural language commands. With this integration, AI assistants can help users automate tasks by creating, updating, and executing n8n workflows without requiring direct interaction with the n8n interface. This bridges the gap between natural language instructions and powerful workflow automation capabilities.

Getting Started with n8n Workflow Manager

This MCP server allows AI assistants to interact with your n8n instance, providing tools to manage workflows and trigger automations through natural language.

Prerequisites

Before installing the n8n Workflow Manager MCP, you'll need:

Node.js 18 or later
An n8n instance with API access enabled
API key or credentials for your n8n instance

Installation Options

Option 1: Install from npm

npm install -g n8n-mcp-server

Option 2: Docker Installation

docker pull leonardsellem/n8n-mcp-server
docker run -p 3000:3000 -e N8N_API_URL=your_n8n_url -e N8N_API_KEY=your_api_key leonardsellem/n8n-mcp-server

Option 3: Manual Installation

Clone the repository:

git clone https://github.com/leonardsellem/n8n-mcp-server.git
cd n8n-mcp-server

Install dependencies:

npm install

Create a .env file based on the example:

cp .env.example .env

Edit the .env file with your n8n instance details:

N8N_API_URL=https://your-n8n-instance.com/api/
N8N_API_KEY=your_api_key
# Or if using basic auth
N8N_USERNAME=your_username
N8N_PASSWORD=your_password
# For webhook authentication
N8N_WEBHOOK_USERNAME=webhook_username
N8N_WEBHOOK_PASSWORD=webhook_password

Start the server:

npm start

Configuration

The MCP server requires the following environment variables:

N8N_API_URL: The URL of your n8n API (e.g., https://your-n8n-instance.com/api/)
N8N_API_KEY: Your n8n API key (if using API key authentication)
N8N_USERNAME and N8N_PASSWORD: Your n8n credentials (if using basic authentication)
N8N_WEBHOOK_USERNAME and N8N_WEBHOOK_PASSWORD: Credentials for webhook authentication (optional)

Usage

Once the MCP server is running, AI assistants can use the provided tools to:

List all workflows in your n8n instance
Get detailed information about specific workflows
Create new workflows from templates or JSON definitions
Update existing workflows
Activate or deactivate workflows
Execute workflows and retrieve results
Monitor execution status
Trigger workflows via webhooks

The assistant will handle the technical details of interacting with the n8n API, allowing you to focus on describing what you want to accomplish in natural language.