n8n-mcp-server

Name: n8n-mcp-server
Author: S17S17

@S17S17

Repository

About n8n-mcp-server

A Model-Controller-Provider (MCP) server implementation for n8n workflow automation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "n8n-mcp-server-s17s17": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "n8n-mcp-server",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is n8n-mcp-server?

A Model-Controller-Provider (MCP) server implementation for n8n workflow automation. It provides a standardized JSON-RPC 2.0 interface for executing and managing n8n workflows.

How to use n8n-mcp-server?

Clone the repository, install dependencies (npm install), and configure required environment variables (N8N_URL, N8N_API_KEY, N8N_API_HEADER). Start the server with npm start or use Docker (docker build -t n8n-mcp-server && docker run -p 3000:3000 --env-file .env n8n-mcp-server).

Key features of n8n-mcp-server

JSON-RPC 2.0 compliant API
Workflow execution and management
Environment-based configuration
TypeScript support
Comprehensive logging
Docker support

Use cases of n8n-mcp-server

Execute n8n workflows programmatically via JSON-RPC
Manage workflow tools from MCP clients
Automate n8n operations in a standardized way
Integrate workflow automation into external applications

FAQ from n8n-mcp-server

What are the prerequisites for using n8n-mcp-server?

Node.js >= 14.0.0, a running n8n instance, and an n8n API key.

What environment variables are required to configure the server?

N8N_URL (n8n instance API URL), N8N_API_KEY (your API key), and N8N_API_HEADER (header name, default: X-N8N-API-KEY).

How can I start the server?

Use npm start for standard mode, npm run start:dev for development with hot reload, npm run start:simple for minimal features, or npm run debug for debug mode.

Does n8n-mcp-server support Docker?

Yes. You can build and run with docker build -t n8n-mcp-server . and docker run -p 3000:3000 --env-file .env n8n-mcp-server, or use docker-compose up.