n8n

czlonkowski/n8n-mcp

🕒 Updated:Nov 11, 2025, 12:00 AM

TypeScript

Development

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations. Features 541 n8n nodes with 99% property coverage and 87% documentation coverage.

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by manualFix

Trust Score0/100

• Core MCP protocol features implemented (23/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:0

👥 Contributors:0

📋 Total Issues:0

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by manualFix

{
  "n8n-mcp-configured": {
    "command": "npx",
    "args": [
      "n8n-mcp"
    ],
    "env": {
      "MCP_MODE": "stdio",
      "LOG_LEVEL": "error",
      "N8N_API_URL": "https://your-instance.n8n.cloud",
      "N8N_API_KEY": "your-api-key",
      "DISABLE_CONSOLE_OUTPUT": "true"
    }
  },
  "n8n-mcp-docker": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "MCP_MODE=stdio",
      "-e",
      "LOG_LEVEL=error",
      "-e",
      "N8N_API_URL=https://your-instance.n8n.cloud",
      "-e",
      "N8N_API_KEY=your-api-key",
      "-e",
      "DISABLE_CONSOLE_OUTPUT=true",
      "ghcr.io/czlonkowski/n8n-mcp:latest"
    ],
    "env": {}
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by manualFix

Tools:✓

Prompts:✗

Resources:✓

Sampling:✗

Roots:✗

Logging:✓

STDIO Transport:✓

HTTP Transport:✗

OAuth2 Auth:✗

Dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by manualFix

Evaluating dependencies...

Check back soon for dependency information

README.md

n8n-MCP

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations.

Features

541 n8n nodes from n8n-nodes-base and @n8n/n8n-nodes-langchain
99% node property coverage with detailed schemas
87% documentation coverage from official n8n docs
271 AI-capable nodes with full documentation
2,646 pre-extracted configurations from popular templates
Smart node search and configuration validation
AI workflow validation

Installation

Quick Start with NPX

npx n8n-mcp

Docker

docker pull ghcr.io/czlonkowski/n8n-mcp:latest

Local Installation

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install && npm run build && npm run rebuild
npm start

Configuration

Environment Variables

Variable	Purpose	Required
`MCP_MODE`	Set to "stdio" for Claude Desktop	Yes
`LOG_LEVEL`	Set to "error" for production	No
`DISABLE_CONSOLE_OUTPUT`	Set to "true" to suppress logs	No
`N8N_API_URL`	Your n8n instance URL	Optional*
`N8N_API_KEY`	API authentication token	Optional*

*API credentials enable workflow management; documentation tools work without them.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "N8N_API_URL": "https://your-instance.n8n.cloud",
        "N8N_API_KEY": "your-api-key",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

License

MIT License - See LICENSE file for details.

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/czlonkowski/n8n-mcp)](https://archestra.ai/mcp-catalog/czlonkowski__n8n-mcp)

Edit This Server Add New MCP Server Report an Issue

README.md

n8n-MCP

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations.

Features

541 n8n nodes from n8n-nodes-base and @n8n/n8n-nodes-langchain
99% node property coverage with detailed schemas
87% documentation coverage from official n8n docs
271 AI-capable nodes with full documentation
2,646 pre-extracted configurations from popular templates
Smart node search and configuration validation
AI workflow validation

Installation

Quick Start with NPX

npx n8n-mcp

Docker

docker pull ghcr.io/czlonkowski/n8n-mcp:latest

Local Installation

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install && npm run build && npm run rebuild
npm start

Configuration

Environment Variables

Variable	Purpose	Required
`MCP_MODE`	Set to "stdio" for Claude Desktop	Yes
`LOG_LEVEL`	Set to "error" for production	No
`DISABLE_CONSOLE_OUTPUT`	Set to "true" to suppress logs	No
`N8N_API_URL`	Your n8n instance URL	Optional*
`N8N_API_KEY`	API authentication token	Optional*

*API credentials enable workflow management; documentation tools work without them.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "N8N_API_URL": "https://your-instance.n8n.cloud",
        "N8N_API_KEY": "your-api-key",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

License

MIT License - See LICENSE file for details.