n8n MCP Server

A comprehensive MCP (Model Context Protocol) server for n8n workflow automation. This connector provides Claude Desktop with ALL available n8n API operations, enabling full workflow management directly from Claude.

Features

Unlike the limited default connector, this server includes 40+ tools covering:

Workflow Management

n8n_list_workflows - List all workflows with filtering
n8n_get_workflow - Get full workflow details including nodes and connections
n8n_create_workflow - Create new workflows with nodes and connections
n8n_update_workflow - Update existing workflows
n8n_delete_workflow - Delete workflows
n8n_activate_workflow - Activate a workflow
n8n_deactivate_workflow - Deactivate a workflow
n8n_run_workflow - Execute a workflow manually
n8n_update_workflow_tags - Update workflow tag associations
n8n_duplicate_workflow - Create a copy of a workflow
n8n_export_workflow - Export workflow as JSON
n8n_import_workflow - Import workflow from JSON
n8n_transfer_workflow - Transfer workflow to another project

Execution Management

n8n_list_executions - List workflow executions with filtering
n8n_get_execution - Get detailed execution information
n8n_delete_execution - Delete a single execution
n8n_delete_executions - Bulk delete executions
n8n_stop_execution - Stop a running execution
n8n_retry_execution - Retry a failed execution

Credential Management

n8n_list_credentials - List all credentials
n8n_get_credential - Get credential details
n8n_create_credential - Create new credentials
n8n_update_credential - Update existing credentials
n8n_delete_credential - Delete credentials
n8n_get_credential_schema - Get required fields for credential type
n8n_transfer_credential - Transfer credential to another project

Tag Management

n8n_list_tags - List all tags
n8n_get_tag - Get tag details
n8n_create_tag - Create new tags
n8n_update_tag - Rename tags
n8n_delete_tag - Delete tags

Variable Management

n8n_list_variables - List all environment variables
n8n_get_variable - Get variable details
n8n_create_variable - Create new variables
n8n_update_variable - Update variables
n8n_delete_variable - Delete variables

Project Management

n8n_list_projects - List all projects
n8n_get_project - Get project details
n8n_create_project - Create new projects
n8n_update_project - Rename projects
n8n_delete_project - Delete projects

User Management

n8n_list_users - List all users
n8n_get_user - Get user details
n8n_get_current_user - Get current authenticated user

Source Control (Git)

n8n_source_control_status - Get Git status
n8n_source_control_pull - Pull changes from remote
n8n_source_control_push - Push changes to remote
n8n_source_control_disconnect - Disconnect Git integration

Security & Utilities

n8n_check_connection - Test API connection
n8n_generate_audit - Generate security audit report
n8n_get_node_types - List available node types
n8n_get_active_webhooks - List active webhooks

Installation

Prerequisites

Node.js 18 or later
n8n instance with API access enabled
n8n API key (generate in n8n Settings → API)

Setup

Clone or download this project:

git clone git@github.com:DrBalls/n8n-mcp-server-v2.git
cd n8n-mcp-server-v2

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configure Claude Desktop:

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Restart Claude Desktop

Configuration

Environment Variables

Variable	Description	Default
`N8N_URL`	Base URL of your n8n instance	`http://localhost:5678`
`N8N_API_KEY`	Your n8n API key	(required)

Getting an API Key

Open your n8n instance
Go to Settings → API
Click Create API Key
Copy the generated key

Usage Examples

Create a Simple Workflow

Create a new n8n workflow called "Hello World" with:
1. A manual trigger node
2. A Set node that outputs {"message": "Hello, World!"}

List and Filter Workflows

Show me all active workflows tagged with "production"

Run a Workflow with Input

Execute workflow ID abc123 with input data: {"email": "test@example.com"}

Manage Credentials

List all Slack credentials and show me the schema for creating new ones

Check Execution Status

Show me the last 10 failed executions and their error messages

Source Control

What's the current Git status? Are there any unpushed changes?

Common Node Types

When creating workflows, use these node type identifiers:

Node	Type String
Manual Trigger	`n8n-nodes-base.manualTrigger`
Schedule Trigger	`n8n-nodes-base.scheduleTrigger`
Webhook	`n8n-nodes-base.webhook`
HTTP Request	`n8n-nodes-base.httpRequest`
Code (JavaScript)	`n8n-nodes-base.code`
Set	`n8n-nodes-base.set`
IF	`n8n-nodes-base.if`
Switch	`n8n-nodes-base.switch`
Merge	`n8n-nodes-base.merge`
Split In Batches	`n8n-nodes-base.splitInBatches`
Wait	`n8n-nodes-base.wait`
No Operation	`n8n-nodes-base.noOp`

Troubleshooting

Connection Failed

Verify your N8N_URL is correct and accessible
Check that your API key is valid
Ensure n8n API access is enabled in settings

Permission Denied

Your API key may not have sufficient permissions
Check if the API user has access to the requested resource

Workflow Not Found

Verify the workflow ID is correct
Check if the workflow exists in the specified project

Development

Building

npm run build

Testing Connection

After building, test the connection:

N8N_URL=http://localhost:5678 N8N_API_KEY=your-key node dist/index.js

License

MIT

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.