n8n

Provides an MCP interface to manage n8n workflows, execute automations, and inspect results via an external client.

typescript

4

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nikolausm-n8n-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/n8n-mcp-server/dist/index.js"
      ],
      "env": {
        "N8N_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

You run an MCP server to let AI assistants interact with your n8n workflows through a simple, REST-based interface. This server exposes workflow management, execution control, tag handling, credential visibility, webhook management, and search capabilities so assistants can orchestrate automation tasks safely and efficiently.

How to use

You connect an MCP client to the server to manage workflows, execute automations, and inspect results. Use the provided tools to list, create, update, and delete workflows, run executions, monitor history, manage tags, and access credentials in a read-only fashion.

How to install

Prerequisites you need before installing the MCP server.

Node.js 18 or higher.
An n8n instance with API access enabled.
An n8n API key.

Install the MCP server globally with npm.

From npm

npm install -g n8n-mcp-server

From source

git clone https://github.com/nikolausm/n8n-mcp-server.git
cd n8n-mcp-server
npm install
npm run build

Available tools

list_workflows

List all workflows with optional filtering such as active status or tags.

get_workflow

Retrieve detailed information about a specific workflow by its identifier.

create_workflow

Create a new workflow from a JSON definition.

update_workflow

Update an existing workflow with new properties or structure.

delete_workflow

Delete a workflow by its identifier.

activate_workflow

Activate a workflow so it can be run.

deactivate_workflow

Deactivate a workflow to prevent execution.

execute_workflow

Execute a workflow with optional input data.

get_executions

Fetch execution history with optional filters.

get_execution

Get details for a specific execution.

delete_execution

Remove an execution record.

retry_execution

Retry a failed execution.

get_tags

List all available tags.

create_tag

Create a new tag for organizing workflows.

update_tag

Update an existing tag.

delete_tag

Delete a tag from the system.

get_credentials

List available credentials (names only).

search_workflows

Search workflows by name or tags.

get_workflow_webhooks

Get webhook URLs associated with a workflow.