Agent skill · software engineering · davila7

n8n-mcp-tools-expert

Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns.

Why this skill is useful

Provides detailed workflows and specific command formats for n8n-mcp tools that the AI wouldn't reliably generate on its own.

What it needs

About 6k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.

What this skill does

n8n MCP Tools Expert Master guide for using n8n-mcp MCP server tools to build workflows. --- Tool Categories n8n-mcp provides 40+ tools organized into categories: 1. Node Discovery → SEARCHGUIDE.md 2. Configuration Validation → VALIDATIONGUIDE.md 3. Workflow Management → WORKFLOWGUIDE.md 4. Template Library - Search and access 2,653 real workflows 5. Documentation - Get tool and node documentation --- Quick Reference Most Used Tools (by success rate) Tool Use When Success Rate Speed ------ ---------- -------------- ------- searchnodes Finding nodes by keyword 99.9% <20ms getnodeessentials Understanding node operations 91.7% <10ms validatenodeoperation Checking configurations Varies <100ms n8ncreateworkflow Creating workflows 96.8% 100-500ms n8nupdatepartialworkflow Editing workflows (MOST USED!) 99.0% 50-200ms validateworkflow Checking complete workflow 95.5% 100-500ms --- Tool Selection Guide Finding the Right Node Workflow: Example: Common pattern: search → essentials (18s average) Validating Configuration Workflow: Common pattern: validate → fix → validate (23s thinking, 58s fixing per cycle) Managing Workflows Workflow: Common pattern: iterative updates (56s average between edits) --- Critical: nodeType Formats Two different formats for different tools! Format 1: Search/Validate Tools Tools that use this: searchnodes (returns this format) getnodeessentials getnodeinfo validatenodeminimal validatenodeoperation getpropertydependencies Format 2: Workflow Tools Tools that use this: n8ncreateworkflow n8nupdatepartialworkflow listnodetemplates Conversion --- Common Mistakes ❌ Mistake 1: Wrong nodeType Format Problem: "Node not found" error ❌ Mistake 2: Using getnodeinfo Instead of getnodeessentials Problem: 20% failure rate, slow response, huge payload When to use getnodeinfo: Debugging complex configuration issues Need complete property schema Exploring advanced features Better alternatives: 1. getnodeessentials - for operations list 2. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills davila7/n8n-mcp-tools-expert

View the source on GitHub

Browse the @skills marketplace