PlugWiki

n8n-mcp-tools-expert Skill for Claude Code: What It Does and How to Install It

Teaches Claude which n8n-mcp tool to call, with which parameters, when it builds or manages n8n workflows.

Installs
8.4K
on skills.sh
Stars
6.6K
on GitHub
Files
5
besides SKILL.md
Updated
Oct 2026
last repo commit

This skill is a guide to the n8n-mcp tools. It covers how to find a node, check its settings, build and edit a workflow, deploy a template, and manage data tables, folders and credentials. It tells Claude to build step by step and to validate between edits.

It needs the n8n-mcp MCP server connected first. Workflow management needs an n8n API URL and key, and some tools need a separate N8N_MCP_ACCESS_TOKEN. It bundles no scripts. The repo's plugin route also adds hooks, which are described under permissions below.

Good for

  • People building n8n workflows through Claude with the n8n-mcp server connected
  • n8n admins who want Claude to manage folders, data tables and credentials without wrong calls
  • Teams who want Claude to audit an n8n instance for hard-coded secrets and open webhooks

Install n8n-mcp-tools-expert

Claude Code

  1. 1

    Copy this prompt.

    Install the n8n-mcp-tools-expert skill in Claude Code. Run this command:
    
    /plugin install czlonkowski/n8n-skills
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin route installs the n8n-mcp-skills plugin: 14 expert skills, a router skill and hooks that run only in Claude Code and Codex plugin installs. The skills CLI and folder routes install only this skill. Either way, the n8n-mcp MCP server must be set up first; its Claude Code commands are the first two methods in the Claude Code tab. For the Claude app, upload the folder as a zip and connect n8n-mcp in that app.

From the project README. Source.

What's in the skill

When it loads

Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, organizing workflows into folders, managing credentials, auditing instance security, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. IMPORTANT — Always consult this skill before calling any n8n-mcp tool — it prevents common mistakes like wrong nodeType formats, incorrect parameter structures, and inefficient tool usage. If the user mentions n8n, workflows, nodes, or automation and you have n8n MCP tools available, use this skill first.

Sections in SKILL.md

  1. Tool Categories
  2. Quick Reference
  3. Most Used Tools (by success rate)
  4. Tool Selection Guide
  5. Finding the Right Node
  6. Validating Configuration
  7. Managing Workflows
  8. Critical: Node JSON Hygiene When Creating Workflows
  9. Critical: nodeType Formats
  10. Format 1: Search/Validate Tools
  11. Format 2: Workflow Tools
  12. Conversion
  13. Common Mistakes
  14. Tool Usage Patterns
  15. Detailed Guides
  16. Node Discovery Tools

Key facts

Installs on skills.sh
8,397 (Nov 2, 2026)
Last repo commit
Oct 24, 2026

What it includes

  • search_nodes then get_node to find a node and read its operations and settings

    Works with no n8n API. The guide says to ask for standard detail first and use full detail sparingly.

    Try: “Find the Slack node and show me what it can do”

    Read · Node discovery

  • validate_node in minimal or full mode, with four profiles, then fix and repeat

    Profiles are minimal, runtime (default), ai-friendly and strict.

    Read · Configuration validation

  • n8n_create_workflow, n8n_update_partial_workflow and n8n_validate_workflow, built in steps

    Needs an n8n API URL and key. The guide tells Claude to build iteratively, include an intent on edits and activate last.

    Try: “Create a workflow that posts new form entries to Slack”

    Write · Workflow management

  • search_templates, get_template and n8n_deploy_template for 2,700+ templates

    Deploying puts a template workflow on your n8n instance and returns the credentials it still needs.

    Write · Template library

  • Runs a workflow: auto, prepare, pinned or direct

    The last three methods go through n8n's MCP server and need N8N_MCP_ACCESS_TOKEN.

    Runs code · n8n_test_workflow

  • n8n_manage_datatable creates tables and edits rows and columns

    deleteRows needs a filter, and the guide says to use dryRun before bulk changes.

    Delete · Data tables

  • n8n_manage_folders creates, renames, moves and deletes folders

    Deleting a folder without a transfer target archives its workflows.

    Delete · Workflow folders

  • n8n_manage_credentials lists, creates, updates and deletes; secrets are not returned

    SKILL.md says get, create and update strip the data field. It says never to put a placeholder credential ID in a node.

    Delete · Credentials

  • n8n_audit_instance runs the built-in audit plus a custom scan for secrets and webhooks

    Detected secrets are masked in the report. Output is a markdown report with a remediation playbook.

    Read · Security audit

  • n8n_manage_agents creates, validates, runs and publishes n8n Agents

    Needs N8N_MCP_ACCESS_TOKEN and n8n 2.34 or newer. Publish only on explicit request; call runs the agent with real credentials and tools.

    Delete · Persisted agents

From the official docs

Permissions

High risk

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It guides tools that delete and overwrite

    The tools it teaches include n8n_delete_workflow, deleteRows, folder delete and credential delete. Use a test instance or a limited API key, and confirm deletes yourself. github.com

  • Running a workflow can have real effects

    n8n_test_workflow with direct runs every node, and SKILL.md says an exposeToMcp retry changes a persistent workflow setting and can overwrite a concurrent UI edit. Ask for approval first. github.com

  • The plugin route adds hooks

    hooks.json registers 9 shell-script commands: SessionStart (startup, resume, clear, compact), PreToolUse on get_node, n8n_create_workflow, n8n_update_partial_workflow, n8n_update_full_workflow, validate_workflow, n8n_validate_workflow, n8n_test_workflow, n8n_instances and n8n_manage_credentials, and PostToolUse on validate_workflow. They read the hook JSON from Claude Code (session id and the tool input, including workflow JSON) with jq or python3 and inject reminders as extra context. session-start.sh creates ~/.cache/n8n-mcp-skills, injects the router skill into the session and deletes some marker files on clear and compact; the other scripts keep marker files under $TMPDIR/n8n-mcp-skills-state. The README says every hook fails open. github.com

  • The plugin installs 15 skill folders

    The marketplace entry lists 14 expert skills plus a router skill that a hook loads into every session. It bundles no MCP server; .mcp.json.example is only an example. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyNone in the skill. Narrow the n8n API key instead.
Talks toYour n8n instance, through the n8n-mcp server (N8N_API_URL)
Sign-in and keysSKILL.md says n8n_manage_credentials never returns secrets and strips the data field; it tells Claude not to inline tokens into text fields.
Scopes
  • Guides n8n-mcp tools that create, update and delete workflows, folders, data tables and credentials

  • Guides activation and test runs of workflows on your n8n instance

  • Needs n8n API key and, for some tools, N8N_MCP_ACCESS_TOKEN

  • The plugin route registers 9 hook commands (shell scripts) in Claude Code

Questions

What does the n8n-mcp-tools-expert skill do?

It tells Claude how to use the n8n-mcp tools: which one to call, what parameter format it expects, and how to build, check and edit workflows in small steps. Its description tells Claude to consult it before any n8n-mcp tool call.

Do I need the n8n-mcp server too?

Yes. The README lists the n8n-mcp MCP server, configured in your .mcp.json, as a prerequisite. The Claude Code tab in the install box includes its install commands. Without the server, the skill has no tools to guide.

How do I install it?

Use the install box above. The README recommends the Claude Code plugin, which installs the whole n8n-mcp-skills set and its hooks. The skills CLI and folder routes install only this skill.

What does the plugin add that the single skill does not?

The plugin lists 15 skill folders: 14 expert skills plus a router skill, and hooks that remind Claude to open the right skill before certain n8n-mcp calls. The README says hooks run only in the Claude Code and Codex plugin install, not in single-skill uploads.

Do I need an n8n API key?

Only for the workflow tools. SKILL.md says search, node details, validation and templates work without an n8n API; creating and editing workflows needs N8N_API_URL and N8N_API_KEY. Agents and some run and history modes also need a separate N8N_MCP_ACCESS_TOKEN.

Does it work in the Claude app?

The README documents uploading a skill folder as a zip under Settings, Capabilities, Skills. The n8n-mcp server still has to be connected in the same app for the tools to exist.

Is it safe?

The skill itself is text, but it guides tools that can create, edit and delete workflows, folders, data tables and credentials on your n8n instance. Our advice: start with a test instance or a key scoped to what you need, and read each change before activating a workflow.

How is it different from the other n8n skills?

This one covers the n8n-mcp tools themselves. The same repo has separate skills for expression syntax, workflow patterns, validation, node configuration, code nodes, error handling, sub-workflows, agents and self-hosting, listed in the README.

Information

updated Nov 2, 2026

Folder
skills/n8n-mcp-tools-expert

czlonkowski/n8n-skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8
  1. README.md · github.com
  2. marketplace.json · github.com
  3. hooks.json · github.com
  4. CLAUDE_CODE_SETUP.md · github.com
  5. SKILL.md · github.com
  6. session-start.sh · github.com
  7. _emit.sh · github.com
  8. validate-workflow.sh · github.com

Updated Nov 2, 2026.