using-n8n-mcp-skills

Routes n8n workflow tasks to the correct specialist skill and documents every n8n-mcp tool.

6.2k|1.0k|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/czlonkowski/n8n-skills --skill using-n8n-mcp-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-n8n-mcp-skills
Source: https://github.com/czlonkowski/n8n-skills/tree/main/skills/using-n8n-mcp-skills
Command: npx skills add https://github.com/czlonkowski/n8n-skills --skill using-n8n-mcp-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When building or debugging n8n workflows through the n8n-mcp MCP server, it is hard to know which specialist skill owns a task, which MCP tool to call, and which rules prevent workflows from silently breaking in production. This router skill answers those questions from turn one.

Core Features & Use Cases

  • Task Routing: A red-flags table and skill index map every n8n task (expressions, Code nodes, validation, agents, credentials, sub-workflows) to the specialist skill that owns it.
  • Tool Reference: A compact working reference for every n8n-mcp tool, including the SHORT vs LONG node-type form trap and the absence of an execute_workflow tool.
  • Production Rules: Three non-negotiables — invoke the matching skill before any n8n action, validate and verify connections before activating, and keep secrets in the credential system.
  • Use Case: A user asks to build a webhook workflow; the router directs the assistant to n8n-workflow-patterns for architecture, n8n-node-configuration for node setup, and n8n-validation-expert before activation.

Quick Start

Ask the assistant to build or fix any n8n workflow and it will consult this router first to pick the right specialist skill.

Frequently Asked Questions about using-n8n-mcp-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an n8n workflow with the n8n-mcp MCP server?

Start with this router skill, which identifies the specialist skill for your task, then use n8n_create_workflow or n8n_update_partial_workflow to build. Always run validate_workflow before activating and call n8n_get_workflow afterward to verify the connections object.

Which n8n-mcp tool should I use for a given task?

Use search_nodes and get_node for discovery, n8n_update_partial_workflow for edits, validate_workflow for validation, and n8n_test_workflow for execution. The router includes a one-line summary of every tool, and the n8n-mcp-tools-expert skill covers selection in depth.

Why does get_node reject my node type in n8n-mcp?

get_node and validate_node take the SHORT node-type form like nodes-base.set, while workflow JSON in validate_workflow and n8n_create_workflow uses the LONG form n8n-nodes-base.set. Mixing the two forms is a common silent mistake.

Is there an execute_workflow tool in n8n-mcp?

No, there is no execute_workflow tool. Use n8n_test_workflow to run workflows with real nodes, choosing a method such as trigger, prepare, pinned, or direct depending on the workflow's trigger type, and inspect results with n8n_executions.

Why did my n8n workflow pass validation but still break?

Validation only confirms the JSON is well-formed; it misses silently dropped wires, Merge index off-by-one errors, and unwired error outputs. Always call n8n_get_workflow after edits to inspect the connections object and run the antipattern scan before activating.

How should API keys and tokens be handled in n8n workflows?

Secrets must go through the n8n credential system, never in text fields or Set nodes. If no native node exists, use the HTTP Request node with the official credential type, and use n8n_manage_credentials for credential CRUD.