What is Mcp N8n Server

mcp-n8n-server is an MCP server designed to provide an interface for integrating with n8n workflows through the Model Context Protocol (MCP). It enables users to connect Claude AI with n8n for automation tasks.

Use cases

Use cases for mcp-n8n-server include automating tasks in business processes, integrating AI functionalities into workflows, and managing data flows between different applications using n8n.

How to use

To use mcp-n8n-server, you can install it globally via npm, run it directly with npx, or clone the repository for local installation. After installation, configure your n8n connection in a .env file and start the server to interact with n8n workflows.

Key features

Key features of mcp-n8n-server include listing all n8n workflows, triggering specific workflows with custom data, and integration with Claude Desktop and other MCP clients.

Where to use

mcp-n8n-server can be used in various fields that require workflow automation, such as software development, data processing, and AI integration, particularly where n8n is utilized.

MCP n8n API Server

An mcp server that provides an interface to interact with n8n workflows through the Model Context Protocol (MCP).

Features

• List all n8n workflows
• Trigger specific workflows with custom data
• Integration with Claude Desktop and other MCP clients

Installation

Global Installation (Recommended for Remote Usage)

npm install -g @ahmad.soliman/mcp-n8n-server

Then configure your n8n connection:

1. Create a .env file in your working directory
2. Add your n8n API information (see Configuration section below)

Using with npx (No Installation Required)

You can run the server directly with npx:

npx -y @ahmad.soliman/mcp-n8n-server

Local Installation

git clone https://github.com/ahmadsoliman/mcp-n8n-server.git
cd mcp-n8n-server
npm install

Configuration

Create a .env file with the following variables:

# n8n Host URL (required)
N8N_HOST_URL=https://your-n8n-instance.com

# n8n Project ID (optional - only needed for cloud instances)
PROJECT_ID=your_project_id_here

# n8n API Key (required)
N8N_API_KEY=your_api_key_here

Usage

As a Remote MCP Server

After installing globally, you can use it as a remote MCP server with Claude AI:

1. Configure Claude AI to use this as a remote MCP server using the following JSON configuration:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@ahmad.soliman/mcp-n8n-server"
      ],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

2. Add the following to your prompt or instructions to Claude:

You have access to a remote MCP server for n8n integration. Use it to:
- List all n8n workflows
- Trigger webhooks and workflows
- Get information about available webhooks

As a Local MCP Server

You can run the server locally and connect to it from Claude Desktop:

# Start the server
npm start

Then configure Claude Desktop to use this MCP server:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@ahmad.soliman/mcp-n8n-server"
      ],
      "env": {
        "N8N_HOST_URL": "",
        "PROJECT_ID": "",
        "N8N_API_KEY": ""
      }
    }
  }
}

Alternatively, if you’ve cloned the repository locally:

{
  "mcpServers": {
    "n8n-server": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/server-n8n/build/index.js"
      ]
    }
  }
}

Setup

1. Install dependencies:

npm install

2. Configure environment variables:

• Copy .env.example to .env (if not already done)
• Update the following variables in .env:
  • N8N_API_URL: Your n8n instance URL (default: http://localhost:5678)
  • N8N_API_KEY: Your n8n API key

3. Start the server:

# Start the MCP server (for integration with Claude Desktop and other MCP clients)
npm run mcp

For development with auto-reload:

npm run dev

MCP Tools (for LLM Integration)

The MCP server exposes the following tools for use with Claude Desktop or other MCP clients:

List Workflows

The list-workflows tool returns a list of all available n8n workflows.

List Workflow Webhooks

The list-workflow-webhooks tool returns all webhooks from a specific workflow.

Parameters:

• id: The ID of the workflow to get webhooks from

Call Webhook (GET)

The call-webhook-get tool allows calling a webhook with a GET request.

Parameters:

• url: The webhook URL to call

Call Webhook (POST)

The call-webhook-post tool allows calling a webhook with a POST request.

Parameters:

• url: The webhook URL to call
• data: Data to send in the POST request body