n8n

You set up an MCP server that exposes all n8n API operations so you can manage workflows, executions, credentials, and more directly from Claude Desktop. This enables full workflow orchestration with a single, centralized MCP endpoint running locally or on your infrastructure.

How to use

Install and run your MCP server, then connect it to your MCP client to start managing n8n workflows from Claude Desktop. You can list, create, update, activate, run, export, import, and transfer workflows; manage executions, credentials, tags, variables, and projects; handle users, source control, and security utilities; and inspect node types and active webhooks. Use the server to perform common administration tasks and incorporate n8n operations into your Claude-powered automation.

How to install

Prerequisites you need before installing: Node.js 18 or later, an n8n instance with API access enabled, and an n8n API key.

1. Clone or download the project and navigate to its directory.

2. Install dependencies.

3. Build the project.

4. Configure Claude Desktop to connect to the MCP server using the local runtime configuration.

5. Restart Claude Desktop after configuration.

# Step 1: clone and install
# (use your own path and project name)
git clone git@github.com:DrBalls/n8n-mcp-server-v2.git
cd n8n-mcp-server-v2

# Step 2: install dependencies
npm install

# Step 3: build the project
npm run build

# Step 4: configure Claude Desktop (see below) and restart

Configure Claude Desktop

Add an MCP server entry to Claude Desktop so it can launch the local MCP server process. The example uses a standard Node runtime to execute the built server.

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["/absolute/path/to/n8n-mcp-server-v2/dist/index.js"],
      "env": {
        "N8N_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available tools

n8n_list_workflows

List all workflows with filtering options to narrow down results by tags, status, or other metadata.

n8n_get_workflow

Retrieve full workflow details including nodes, connections, and configuration.

n8n_create_workflow

Create a new workflow with specified nodes and connections.

n8n_update_workflow

Update an existing workflow's properties and configuration.

n8n_delete_workflow

Delete a workflow by its identifier.

n8n_activate_workflow

Activate a workflow so it can run in response to triggers.

n8n_deactivate_workflow

Deactivate a workflow to suspend automatic execution.

n8n_run_workflow

Manually trigger execution of a workflow with optional input data.

n8n_update_workflow_tags

Update the tag associations for a workflow.

n8n_duplicate_workflow

Create a copy of an existing workflow.

n8n_export_workflow

Export a workflow to JSON format for backup or transfer.

n8n_import_workflow

Import a workflow from JSON to recreate or restore it.

n8n_transfer_workflow

Move a workflow to another project.

n8n_list_executions

List all workflow executions with optional filters.

n8n_get_execution

Get detailed information about a specific execution.

n8n_delete_execution

Delete a single execution by its identifier.

n8n_delete_executions

Bulk delete multiple executions.

n8n_stop_execution

Stop a running workflow execution.

n8n_retry_execution

Retry a failed execution.

n8n_list_credentials

List all stored credentials.

n8n_get_credential

Get details of a specific credential.

n8n_create_credential

Create new credentials for a service.

n8n_update_credential

Update an existing credential.

n8n_delete_credential

Delete credentials.

n8n_get_credential_schema

Retrieve required fields for a credential type.

n8n_transfer_credential

Transfer a credential to another project.

n8n_list_tags

List all tags used to categorize resources.

n8n_get_tag

Get details for a specific tag.

n8n_create_tag

Create new tags.

n8n_update_tag

Rename or modify existing tags.

n8n_delete_tag

Delete tags.

n8n_list_variables

List all environment variables managed by the server.

n8n_get_variable

Get details for a specific variable.

n8n_create_variable

Create new environment variables.

n8n_update_variable

Update existing variables.

n8n_delete_variable

Delete variables.

n8n_list_projects

List all projects.

n8n_get_project

Get details for a project.

n8n_create_project

Create a new project.

n8n_update_project

Rename or modify a project.

n8n_delete_project

Delete a project.

n8n_list_users

List all users.

n8n_get_user

Get details for a specific user.

n8n_get_current_user

Get details for the currently authenticated user.

n8n_source_control_status

Get Git status information for source control.

n8n_source_control_pull

Pull changes from the remote repository.

n8n_source_control_push

Push local changes to the remote repository.

n8n_source_control_disconnect

Disconnect Git integration.

n8n_check_connection

Test the API connection to ensure reachability.

n8n_generate_audit

Generate a security audit report.

n8n_get_node_types

List available node types supported by n8n.

n8n_get_active_webhooks

List active webhooks configured for the account.