DrBalls/n8n-mcp-server-v2

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

1. Clone or download this project:

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

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. 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"
         }
       }
     }
   }
   

5. Restart Claude Desktop

Configuration

Environment Variables

Getting an API Key

1. Open your n8n instance
2. Go to Settings → API
3. Click Create API Key
4. 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:

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.