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
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
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
- Tool Categories
- Quick Reference
- Most Used Tools (by success rate)
- Tool Selection Guide
- Finding the Right Node
- Validating Configuration
- Managing Workflows
- Critical: Node JSON Hygiene When Creating Workflows
- Critical: nodeType Formats
- Format 1: Search/Validate Tools
- Format 2: Workflow Tools
- Conversion
- Common Mistakes
- Tool Usage Patterns
- Detailed Guides
- 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 discoveryvalidate_node in minimal or full mode, with four profiles, then fix and repeat
Profiles are minimal, runtime (default), ai-friendly and strict.
Read ·
Configuration validationn8n_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 managementsearch_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 libraryRuns 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_workflown8n_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 tablesn8n_manage_folders creates, renames, moves and deletes folders
Deleting a folder without a transfer target archives its workflows.
Delete ·
Workflow foldersn8n_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 ·
Credentialsn8n_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 auditn8n_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-only | None in the skill. Narrow the n8n API key instead. |
|---|---|
| Talks to | Your n8n instance, through the n8n-mcp server (N8N_API_URL) |
| Sign-in and keys | SKILL.md says n8n_manage_credentials never returns secrets and strips the data field; it tells Claude not to inline tokens into text fields. |
| Scopes |
|
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
- Repository
- czlonkowski/n8n-skills
- Folder
skills/n8n-mcp-tools-expert
Sources
Docs, issue trackers and discussions this page is built from.
Show all 8Hide
- README.md · github.com
- marketplace.json · github.com
- hooks.json · github.com
- CLAUDE_CODE_SETUP.md · github.com
- SKILL.md · github.com
- session-start.sh · github.com
- _emit.sh · github.com
- validate-workflow.sh · github.com